JSON.stringify — стандартный метод в языке JavaScript, предназначенный для преобразования значений JavaScript в строковое представление в формате JSON (JavaScript Object Notation). Метод обычно используется для сериализации объектов, массивов, чисел, булевых значений и строк с целью передачи данных между средами, сохранения в хранилище или логирования. Поведение метода определено в спецификации ECMAScript и реализуется во всех современных движках JavaScript, обеспечивая совместимость и предсказуемость выходной строки.
Ключевые аспекты включают управление порядком и форматом выводимых данных, обработку специальных значений (например, undefined, функции и символы), а также поддержку опциональных параметров, которые позволяют задавать фильтрацию свойств и форматирование отступов. Метод применяется как в клиентских, так и в серверных средах JavaScript, чаще всего в сочетании с операциями передачи данных по сети, сохранения состояния или подготовки данных к межъязыковому обмену.
Реализация может различаться в деталях (например, порядок перечисления свойств у нестандартных объектов), но общие правила сериализации остаются стабильными: примитивы преобразуются в соответствующие литералы JSON, объекты и массивы рекурсивно обходятся, а некоторые типы и значения приводятся к null или опускаются согласно спецификации.
- Синтаксис и параметры: принимает значение для сериализации и два необязательных аргумента — replacer (функция или массив ключей для фильтрации/замены) и space (число или строка для форматирования отступов).
- Обработка типов: простые типы (строки, числа, булевы значения) преобразуются в соответствующие JSON-литералы; undefined, функции и символы в объектах обычно исключаются из результата, в массивах заменяются null.
- Рекурсивность и циклы: при обходе объектов метод рекурсивно сериализует вложенные значения; циклические ссылки приводят к выбрасыванию ошибки TypeError, если не применён механизм замены.
- Replacer: параметр-функция позволяет изменять или фильтровать значения во время сериализации; параметр-массив ограничивает набор свойств, включаемых в итоговую строку.
- Форматирование: параметр space управляет отступами и приведением к читабельному виду, что полезно для отладки или хранения конфигов в человекочитаемом формате.
- Безопасность и строгость: метод не выполняет код и не вызывает побочных эффектов при обычной сериализации, однако перед сериализацией следует учитывать возможное включение чувствительных данных и размер результирующей строки.
- Совместимость: результирующая строка соответствует нотации JSON и может быть обратно распарсена стандартными средствами (например, JSON.parse) в совместимых средах.
- Ограничения: не все внутренние представления и специальные объекты (например, Map, Set, Date, RegExp) приводятся к удобному или ожидаемому формату по умолчанию и могут требовать явной трансформации через replacer или предварительную конвертацию.