все Python 3jsonфункция

json.load

json

Читает JSON из файлового объекта и возвращает объект Python.

Синтаксис

json.load(fp)

Несмотря на «файловый» вид, потоковости здесь нет: load по сути делает loads(fp.read()) и держит весь документ в памяти, так что для огромных файлов берут формат JSON Lines (разбирать построчно) или сторонний ijson. В файле должен лежать ровно один JSON-документ: два объекта подряд или любой лишний текст после него дают JSONDecodeError с сообщением про Extra data.

Примеры

import json, io
print(json.load(io.StringIO('[1, 2, 3]')))   # → [1, 2, 3]
print(json.load(io.StringIO('{"name": "Bob", "age": 30}')))   # → {'name': 'Bob', 'age': 30}
data = json.load(io.StringIO('{"items": [1, 2, 3]}'))
print(sum(data['items']))   # → 6
print(json.load(io.StringIO('')))   # → JSONDecodeError (пустой ввод)

См. также

Частые ошибки

Открыть в полном глоссарииdocs.python.orgСообщить о неточности