Объект JSON.

  JSON - Объект для конвертации значений формата JavaScript JavaScript в формат JSON (JavaScript Object Notation — текстовый формат обмена данными JavaScript), или наоборот.
  Экземпляр доступен:
  • В одноименной переменной JSON
  Методы.
  parse - Преобразует строку, заданную в формате JSON,, в соответствующее значение формата JavaScript.
  Возвращает полученное значение формата JavaScript.

Формат записи в коде скрипта:

  • JSON.parse(Строка[, Функция])

Значения формата записи:

  • JSON - Ключевое слово.
  • . - Оператор доступа к методу объекта.
  • parse - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Строка - Допустимая строка JSON.
      Если строка не содержит строгого кода JSON, то возникнет ошибка syntaxerror.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • Функция - Любой формат записи функции, которую необходимо вызывать при преобразовании строки.
      При преобразовании строки содержащей непосредственную запись массива или непосредственную запись объекта, строка сначала разбирается методом parse на части, которые содержат элементы массива или свойства объекта с их значениями.
      Затем разобранная строка последовательно собирается, при этом каждая часть разобранной строки, перед её сборкой предаётся функции.

      Функция должна иметь два аргумента.
      В первом аргументе метод parse передаст индекс элемента или имя свойства.
      Во втором аргументе метод parse передаст значение элемента или значение свойства.

      Таким образом, функция будет вызвана методом parse столько раз, на сколько частей разобрана строка, плюс еще один раз. В последнем вызове первый аргумент будет пустым, а второй получит значение самого массива или объекта.

      При преобразовании строки содержащей любое другое значение кроме непосредственной записи массива или непосредственной записи объекта, метод parse вызовет функцию только один раз, при этом первый аргумент будет пустым, а второй получит значение самой преобразованной строки.

      Во всех случаях:
    • Если Функция возвращает допустимое значение, то значение, переданное ей во втором аргументе, заменяется этим значением в возвращённой методом parse строке.
    • Если Функция возвращает то же значение, что она получила, то значение, переданное ей во втором аргументе, не изменяется в возвращённой методом parse строке.
    • Если Функция возвращает значение null или undefined, то значение, переданное ей во втором аргументе, удаляется в возвращённой методом parse строке.
  • ) - Оператор группировки. Ключевое слово в этом формате.
  stringify - Преобразует значение формата JavaScript в строку JSON.
  Возвращает строку строгого кода JSON.
  У объекта Date есть собственный метод для такого преобразования.

Формат записи в коде скрипта:

  • JSON.stringify(Значение[, Функция|Массив][, Разделитель])

Значения формата записи:

  • JSON - Ключевое слово.
  • . - Оператор доступа к методу объекта.
  • stringify - Ключевое слово.
  • ( - Оператор группировки. Ключевое слово в этом формате.
  • Значение - Значение для преобразования заданное в любом допустимом формате JavaScript.
  • , - Оператор группировки. Ключевое слово в этом формате.
  • Функция - Любой формат записи функции, которую необходимо вызывать при преобразовании значения.
      При преобразовании массива или объекта, значение сначала разбирается методом stringify на части, которые содержат элементы массива или свойства объекта с их значениями.
      Затем разобранное значение последовательно собирается, при этом каждая часть разобранного значения, перед его сборкой предаётся функции.

      Функция должна иметь два аргумента.
      В первом аргументе метод stringify передаст индекс элемента или имя свойства.
      Во втором аргументе метод stringify передаст значение элемента или значение свойства.

      Таким образом, функция будет вызвана методом stringify столько раз, на сколько частей разобрано значение, плюс еще один раз. В первом вызове первый аргумент будет пустым, а второй получит значение самого массива или объекта.

      При преобразовании любого другого значения кроме массива или объекта, метод stringify вызовет функцию только один раз, при этом первый аргумент будет пустым, а второй получит само преобразованное значение.

      Во всех случаях:
    • Если Функция возвращает допустимое значение, то значение, переданное ей во втором аргументе, заменяется этим значением в возвращённой методом stringify строке.
    • Если Функция возвращает то же значение, что она получила, то значение, переданное ей во втором аргументе, не изменяется в возвращённой методом stringify строке.
    • Если Функция возвращает значение null или undefined, то значение, переданное ей во втором аргументе, удаляется в возвращённой методом stringify строке.
  • Массив - Массив, используемый для преобразования.
      При преобразовании массива или объекта, в строку возвращаемого значения попадут только элементы массива или свойства объекта, которые совпадают с соответствующими индексами элементов или именами свойств заданными этим аргументом массив.
      Аргумент массив ни как не воспринимается, если значение не массив или не объект.
  • Разделитель - Задает разделитель значений элементов или свойств, если значением является массив или объект.
      Если это число, то в строку возвращаемого значения вставляются отступы на это число пробелов на каждом уровне.
      Если это число больше 10, отступы в строке составляют 10 пробелов.
      Если это строка, то в строку возвращаемого значения в качестве отступа на каждом уровне вставляются символы этой строки.
      Если строка разделителя длиннее 10 символов, то используются первые 10 символов.
      Аргумент разделитель ни как не воспринимается, если значение не массив или не объект.
  • ) - Оператор группировки. Ключевое слово в этом формате.