Espruino:Справочник по API/Библиотека Storage/readJSON(): различия между версиями
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Myagkij (обсуждение | вклад) (Новая страница: «{{Espruino/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =<ref>[ www.espruino.com - ]</ref>= ==Синтакс...») |
Myagkij (обсуждение | вклад) Нет описания правки |
||
(не показаны 4 промежуточные версии 2 участников) | |||
Строка 3: | Строка 3: | ||
{{Myagkij-редактор}} | {{Myagkij-редактор}} | ||
=<ref>[ www.espruino.com - ]</ref>= | =Функция Storage.readJSON()<ref>[https://www.espruino.com/Reference#l_Storage_readJSON www.espruino.com - require("Storage").readJSON(name, noExceptions)]</ref>= | ||
==Синтаксис== | ==Синтаксис== | ||
<syntaxhighlight lang="javascript" | <syntaxhighlight lang="javascript"> | ||
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-данными, она возбудит исключение. | |||
{{Примечание1|Эту функцию необходимо использовать с обычными файлами, а не с файлами типа [https://www.espruino.com/Reference#StorageFile StorageFile], созданными с помощью require("Storage").open(filename, ...).}} | |||
{{Примечание1|Эта функция не доступна для устройств с маленькой flash-памятью.}} | |||
== Примеры == | == Примеры == | ||
Строка 29: | Строка 36: | ||
=См.также= | =См.также= | ||
=Внешние ссылки= | =Внешние ссылки= | ||
Строка 35: | Строка 42: | ||
<references /> | <references /> | ||
{{Навигационная таблица/Espruino | {{Навигационная таблица/Портал/Espruino}} | ||
Текущая версия от 18:06, 28 мая 2023
Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.
Функция 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-данными, она возбудит исключение.
Примеры
См.также
Внешние ссылки