Espruino:Справочник по API/Библиотека Storage/readJSON(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
(Новая страница: «{{Espruino/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =<ref>[ www.espruino.com - ]</ref>= ==Синтакс...»)
 
Нет описания правки
 
(не показаны 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" enclose="div">
<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:
=См.также=
=См.также=


{{ads}}
 


=Внешние ссылки=
=Внешние ссылки=
Строка 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-данными, она возбудит исключение.

Примечание

Эту функцию необходимо использовать с обычными файлами, а не с файлами типа StorageFile, созданными с помощью require("Storage").open(filename, ...).

Примечание

Эта функция не доступна для устройств с маленькой flash-памятью.

Примеры

См.также

Внешние ссылки