Spec-Zone.ru › Web Extensions

tabs.removeCSS()

Удаляет из страницы CSS, который был ранее вставлен с помощью вызова tabs.insertCSS().

Примечание: При использовании Manifest V3 или более поздней версии, используйте scripting.insertCSS() и scripting.removeCSS() для вставки и удаления CSS.

Это асинхронная функция, которая возвращает Promise.

Синтаксис

let removing = browser.tabs.removeCSS(
  tabId,           // optional integer
  details          // object
)

Параметры

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

integer. Идентификатор вкладки, из которой необходимо удалить CSS. По умолчанию используется активная вкладка текущего окна.

details

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

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

boolean. Если true, код будет удалён из всех фреймов текущей страницы. Если false, код удаляется только из основного фрейма. По умолчанию false.

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

string. CSS для удаления, как строка текста. Она должна точно соответствовать строке CSS, ранее вставленной на страницу с помощью tabs.insertCSS().

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

string. Может принимать одно из двух значений: "user", для CSS, добавленного как пользовательские стили, или "author", для CSS, добавленного как стили автора. Если этот параметр был установлен ранее с помощью tabs.insertCSS(), он должен точно совпадать.

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

string. Путь к файлу, содержащему CSS для удаления. Он должен точно соответствовать CSS-файлу, ранее вставленному на страницу с помощью tabs.insertCSS().

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

integer. Фрейм, из которого необходимо удалить CSS. По умолчанию 0 (главный фрейм).

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

boolean. Если true, CSS будет удалён из встроенных фреймов «about:blank» и «about:srcdoc», если расширение имеет доступ к их родительскому документу. По умолчанию false.

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

A Promise, который будет выполнен без аргументов, когда весь CSS будет удалён. Если произойдёт какая-либо ошибка, промис будет отклонен с сообщением об ошибке.

Примеры

В этом примере используется tabs.insertCSS для добавления CSS, а затем он удаляется при нажатии пользователем действия браузера:

let css = "body { border: 20px dotted pink; }";

function onError(error) {
  console.log(`Error: ${error}`);
}

let insertingCSS = browser.tabs.insertCSS(2, {code: css});
insertingCSS.then(null, onError);

browser.browserAction.onClicked.addListener(() => {
  let removing = browser.tabs.removeCSS(2, {code: css});
  removing.then(null, onError);
});

Примеры расширений

  • apply-css
  • beastify

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

Рабочий стол Мобильные
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
removeCSS
87Доступно только для Manifest V2.
87Доступно только для Manifest V2.
49Доступно только для Manifest V2.
?
73Доступно только для Manifest V2.
14Доступно только для Manifest V2.
? ?
54Доступно только для Manifest V2.
?
15Доступно только для Manifest V2.
?

Примечание: Этот API основан на API chrome.tabs Chromium. Данная документация взята из tabs.json в коде Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/tabs/removeCSS

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API