dart:convert

Метод convert

Преобразует object в JSON строку.

Непосредственно сериализуемые значения — это число, строка, логическое значение и null, а также некоторые значения списка и словаря. Для списка все элементы должны быть сериализуемыми. Для словаря ключи должны быть строками, а значения — сериализуемыми.

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

Если преобразование завершается ошибкой или возвращает значение, которое не является непосредственно сериализуемым, выбрасывается исключение JsonUnsupportedObjectError. Если вызов завершается ошибкой, ошибка обрабатывается и хранится в поле JsonUnsupportedObjectError cause.

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

object не должен изменяться во время сериализации.

Если объект сериализуется более одного раза, convert может кэшировать текст для него. Другими словами, если содержимое объекта изменяется после его первой сериализации, новые значения могут не отражаться в результате.

Реализация

String convert(Object? object) =>
    _JsonStringStringifier.stringify(object, _toEncodable, indent);