WorkerGlobalScope: метод structuredClone()

Базовая версия Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузера. Она доступна в браузерах с марта 2022 года.

Примечание: Эта функция доступна только в Web Workers.

Метод structuredClone() интерфейса WorkerGlobalScope создаёт глубокую копию заданного значения с использованием алгоритма структурного клонирования.

Метод также позволяет передающим объектам в исходном значении быть переданными, а не клонированными, в новый объект. Переданные объекты отсоединяются от исходного объекта и прикрепляются к новому объекту; они больше недоступны в исходном объекте.

Синтаксис

structuredClone(value)
structuredClone(value, options)

Параметры

value

Объект, который необходимо клонировать. Это может быть любой структурно клонируемый тип.

options Необязательно

Объект со следующими свойствами:

transfer: Массив передающих объектов, которые будут перемещены, а не скопированы, в возвращаемый объект.

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

Глубокая копия исходного value.

Исключения

DataCloneError DOMException: Выбрасывается, если какая-либо часть входного значения не может быть сериализована.

Описание

Подробности этой функции см. в Window.structuredClone().

Примеры

Примеры см. в Window.structuredClone().

Спецификации

Спецификация
HTML # dom-structuredclone

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`structuredClone`	98	98	94	84	15.4	98	94	68	15.4	18.0	98

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WorkerGlobalScope/structuredClone