DOMTokenList: метод replace()

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

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

Метод replace() интерфейса DOMTokenList заменяет существующий токен новым. Если первого токена не существует, replace() возвращает false сразу, без добавления нового токена в список.

Синтаксис

replace(oldToken, newToken)

Параметры

oldToken: Строка, представляющая токен, который требуется заменить.
newToken: Строка, представляющая токен, на который требуется заменить oldToken.

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

Булевое значение, которое является true , если oldToken был успешно заменён, или false в противном случае.

Примеры

В следующем примере мы получаем список классов, установленных на элементе <span>, как DOMTokenList с помощью Element.classList. Затем мы заменяем токен в списке и записываем список в Node.textContent элемента <span>.

Сначала HTML:

<span class="a b c"></span>

Теперь JavaScript:

const span = document.querySelector("span");
const classes = span.classList;

const result = classes.replace("c", "z");

span.textContent = result ? classes : "token not replaced successfully";

Вывод выглядит так:

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

Спецификация
DOM # ref-for-dom-domtokenlist-replace①

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`replace`	61	17	49	48	10.1	61	49	45	10.3	8.0	61
`boolean_value`	67	18	61	54	12	67	61	48	12	9.0	67

© 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/DOMTokenList/replace