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); });
Примеры расширений
Совместимость с браузерами
| Рабочий стол | Мобильные | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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