NodeIterator: метод detach()

Устаревший: Данная функция больше не рекомендуется. Несмотря на то, что некоторые браузеры могут её поддерживать, она может быть удалена из соответствующих веб-стандартов, может быть в процессе удаления или поддерживаться только для совместимости. Избегайте её использования и, если возможно, обновите существующий код; обратитесь к таблице совместимости внизу этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любое время.

Метод NodeIterator.detach() является пустой операцией, поддерживаемой только для обратной совместимости.

Изначально он отсоединял NodeIterator от набора, над которым он итерируется, освобождая все ресурсы, используемые набором, и устанавливая состояние итератора в INVALID. После вызова этого метода вызовы других методов на NodeIterator вызывали бы исключение INVALID_STATE_ERR.

Синтаксис

detach()

Параметры

Нет.

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

Нет (undefined).

Примеры

const nodeIterator = document.createNodeIterator(
  document.body,
  NodeFilter.SHOW_ELEMENT,
  {
    acceptNode(node) {
      return NodeFilter.FILTER_ACCEPT;
    },
  },
);
nodeIterator.detach(); // detaches the iterator

nodeIterator.nextNode(); // throws an INVALID_STATE_ERR exception

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

Спецификация
DOM # dom-nodeiterator-detach

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`detach`	1	12	3.5–22	9	3	18	4–22	10.1	3	1.0	4.4

См. также

Интерфейс, к которому он относится: NodeIterator.

© 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/NodeIterator/detach