Espruino:Справочник по API/Библиотека Storage/readJSON(): различия между версиями
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Myagkij (обсуждение | вклад) Нет описания правки |
Myagkij (обсуждение | вклад) Нет описания правки |
||
Строка 3: | Строка 3: | ||
{{Myagkij-редактор}} | {{Myagkij-редактор}} | ||
=<ref>[https://www.espruino.com/Reference#l_Storage_readJSON www.espruino.com - require("Storage").readJSON(name, noExceptions)]</ref>= | =Функция Storage.readJSON()<ref>[https://www.espruino.com/Reference#l_Storage_readJSON www.espruino.com - require("Storage").readJSON(name, noExceptions)]</ref>= | ||
==Синтаксис== | ==Синтаксис== | ||
<syntaxhighlight lang="javascript" enclose="div"> | <syntaxhighlight lang="javascript" enclose="div"> | ||
require("Storage").readJSON(name, noExceptions) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==Параметры== | ==Параметры== | ||
* '''name''' – название файла (максимум 28 символов; чувствителен к регистру символов) | |||
* '''noExceptions''' – если задать здесь true, и заданный JSON-файл окажется некорректным, функция просто вернет undefined. В противном случае будет возбуждено исключение Exception | |||
==Возвращаемое значение== | ==Возвращаемое значение== | ||
Объект, содержащий пропарсенные JSON-данные из файла, или undefined. | |||
==Описание== | |||
Считывает файл из Storage-области flash-памяти, который был записан с помощью функции require("Storage").write(...), а также парсит JSON в JavaScript-объект. | |||
Действие этой функции идентично JSON.parse(require("Storage").read(...)). Если данные в файле не будут корректными JSON-данными, она возбудит исключение. | |||
'''Примечание:''' Эту функцию необходимо использовать с обычными файлами, а не с файлами типа [https://www.espruino.com/Reference#StorageFile StorageFile], созданными с помощью require("Storage").open(filename, ...). | |||
'''Примечание:''' Эта функция не доступна для устройств с маленькой flash-памятью. | |||
== Примеры == | == Примеры == |
Версия от 14:05, 28 февраля 2021
Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.
Функция Storage.readJSON()[1]
Синтаксис
require("Storage").readJSON(name, noExceptions)
Параметры
- name – название файла (максимум 28 символов; чувствителен к регистру символов)
- noExceptions – если задать здесь true, и заданный JSON-файл окажется некорректным, функция просто вернет undefined. В противном случае будет возбуждено исключение Exception
Возвращаемое значение
Объект, содержащий пропарсенные JSON-данные из файла, или undefined.
Описание
Считывает файл из Storage-области flash-памяти, который был записан с помощью функции require("Storage").write(...), а также парсит JSON в JavaScript-объект.
Действие этой функции идентично JSON.parse(require("Storage").read(...)). Если данные в файле не будут корректными JSON-данными, она возбудит исключение.
Примечание: Эту функцию необходимо использовать с обычными файлами, а не с файлами типа StorageFile, созданными с помощью require("Storage").open(filename, ...).
Примечание: Эта функция не доступна для устройств с маленькой flash-памятью.
Примеры
См.также
Внешние ссылки