Spec-Zone.ru › jQuery

jQuery.parseJSON()

jQuery.parseJSON( json )Возвращает: Строка или Число или Объект или Массив или Булево значениеверсия устарела: 3.0

Описание: Принимает правильно сформированную строку JSON и возвращает соответствующее значение JavaScript.

  • версия добавлена: 1.4.1jQuery.parseJSON( json )

    • json
      Тип: Строка
      Строка JSON для разбора.

Начиная с jQuery 3.0, $.parseJSON устарела. Для разбора строк JSON используйте встроенный метод JSON.parse вместо этого.

Передача некорректной строки JSON приводит к исключению JavaScript. Например, следующие строки JSON некорректны:

  • "{test: 1}" (тест не заключен в двойные кавычки).
  • "{'test': 1}" ('test' использует одинарные кавычки вместо двойных).
  • "'test'" ('test' использует одинарные кавычки вместо двойных).
  • ".1" (число должно начинаться с цифры; "0.1" было бы допустимо).
  • "undefined" (undefined не может быть представлено в строке JSON; null, однако, может быть).
  • "NaN" (NaN не может быть представлено в строке JSON; прямое представление Infinity также запрещено).

Стандарт JSON не допускает "управляющих символов", таких как табуляция или перевод строки. Пример вроде $.parseJSON( '{ "testing":"1\t2\n3" }' ) вызовет ошибку в большинстве реализаций, потому что JavaScript-парсер преобразует экранированные в строке табуляцию и перевод строки в буквальные символы табуляции и перевода строки; удвоение обратных слешей, как в "1\\t2\\n3", даёт ожидаемые результаты. Эта проблема часто встречается при вставке JSON из серверного языка, такого как PHP, в JavaScript-файл.

Если браузер предоставляет встроенную реализацию JSON.parse, jQuery использует её для разбора строки. Подробную информацию о формате JSON см. на странице https://json.org/.

До jQuery 1.9, $.parseJSON возвращала null вместо выброса ошибки, если ей передавалась пустая строка, null, или undefined, хотя они не являются корректным JSON.

Пример:

Разбор строки JSON.

var obj = jQuery.parseJSON( '{ "name": "John" }' );
alert( obj.name === "John" );

© The jQuery Foundation and other contributors
Licensed under the MIT License.
https://api.jquery.com/jQuery.parseJSON

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API