JavaScript. Подробное руководство, 6-е издание, стр. 430

 return value

});

См. также

JSON.stringify(), раздел 6.9

JSON.stringify() (ECMAScript 5)

сериализует объект, массив или элементарное значение

Синтаксис

JSON.stringify(o)

JSON.stringify(o, filter)

JSON.stringify(o, filter, indent)

Arguments

о Объект, массив или элементарное значение, которое требуется преобразовать в строку в формате JSON.

filter Необязательная функция, которая может изменять значения перед сериализацией, или массив имен свойств, подлежащих сериализации.

indent Необязательный аргумент, определяющий строку или число пробелов для оформления отступов, когда требуется применить форматирование для удобочитаемости. Если отсутствует, возвращаемая строка не содержит дополнительных пробелов, но вполне понятна для человека.

Возвращаемое значение

Cстрока в формате JSON представляющая значение о после применения фильтра filter и отформатированная с применением indent.

Описание

Функция

JSON.stringify()

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

JSON.parse()

. Обычно эта функция вызывается с единственным аргументом и возвращает соответствующую строку.

Когда функция

JSON.stringifу()

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

JSON.stringify()

встретит объект (или массив) с методом

toJSON(),

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

toJS0N()

с единственным строковым аргументом, в котором передается имя свойства объекта или индекс массива. Класс

Date

определяет метод

toJSON(),

преобразующий объекты

Date

в строки с помощью метода

Date.toISOString()

. Никакие другие классы, встроенные в язык JavaScript, не определяют метод

toJSON(),

но вы можете определить его в своих классах. Помните, что несмотря на свое имя, метод

toJSON()

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

JSON.stringify()

позволяет добавить в процесс сериализаци второй слой фильтрации. Этот необязательный аргумент может быть функцией или массивом и предоставляет возможность реализации двух разных способов фильтрации. Если передать во втором аргументе функцию, она будет использоваться как инструмент замены, подобно методу

toJSON(),

описанному выше. Эта функция будет вызываться для каждого значения, подлежащего сериализации. Ключевое слово this внутри этой функции замены будет ссылаться на объект или массив, в котором определено текущее значение. Первым аргументом функции замены будет передаваться имя свойства объекта или индекс в массиве для текущего значения, а во втором - само значение. Это значение будет замещено возвращаемым значением функции. Если функция вернет undefined или вообще ничего не вернет, то это значение (и соответствующее ему свойство объекта или элемент массива) будет исключено из сериализации.

Если во втором аргументе передать массив строк (или чисел - они будут преобразованы в строки), эти строки будут использоваться как имена свойств объекта. Любое свойство, имя которого отсутствует в массиве, будет исключено из сериализации. Кроме того, возвращаемая строка будет содержать свойства в том же порядке, в каком они перечислены в массиве.

Функция

JSON.stringify()

обычно возвращает строку без дополнительных пробелов и символов перевода строки. Если желательно сделать результат более удобочитаемым, можно передать третий агумент. Если указать в нем число от 1 до 10, функция

JSON.stringify()

вставит символы перевода строки и будет использовать указанное число пробелов для оформления отступов на каждом «уровне» вложенности. Если в этом аргументе передать непустую строку, функция

JSON.stringify()

вставит символы перевода строки и будет использовать указанную строку (но не более 10 первых символов из нее) для оформления отступов.

Примеры

// Простая сериализация

var text = JSON.stringify(data);

// Указать точно, какие поля подлежат сериализации

var text = JSON.stringify(address, ["city”,"state","country"]);

<b>// Указать функцию замены, чтобы можно было сериализовать объекты RegExp</b>

var text = JSON.stringify(patterns, function(key, value) {

 if (value.constructor === RegExp) return value.toString();

 return value;

});

// Того же эффекта можно добиться иначе:

RegExp.prototype.toJSON = function() { return this.toString(); }

См. также

JSON.parse(), раздел 6.9

Math

Math

математические функции и константы

Синтаксис

Math.константа 

Math.функция()

Константы

Math.Е Константа е, основание натуральных логарифмов.

Math.LN10 Натуральный логарифм числа 10.