Private browsing window access permission clarifications (mdn#19980)

teoli2003 · Sep 7, 2022 · 4888621 · 4888621
1 parent fed2945
commit 4888621
Show file tree

Hide file tree

Showing 3 changed files with 3 additions and 3 deletions.
diff --git a/files/en-us/mozilla/add-ons/webextensions/api/contentscripts/register/index.md b/files/en-us/mozilla/add-ons/webextensions/api/contentscripts/register/index.md
@@ -40,7 +40,7 @@ let registering = browser.contentScripts.register(
  - `allFrames` {{optional_inline}}
  - : Same as `all_frames` in the [`content_scripts`](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts) key.
  - `cookieStoreId` {{optional_inline}}
- - : A string or array of strings. Registers the content script in the tabs that belong to one or more cookie store IDs. This enables scripts to be registered for all default or non-contextual identity tabs, private browsing tabs (if extensions are enabled in private browsing), the tabs of a [contextual identity](/en-US/docs/Mozilla/Add-ons/WebExtensions/Work_with_contextual_identities), or a combination of these.
+ - : A string or array of strings. Registers the content script in the tabs that belong to one or more cookie store IDs. This enables scripts to be registered for all default or non-contextual identity tabs, private browsing tabs (if the [extension is enabled in private browsing](https://support.mozilla.org/en-US/kb/extensions-private-browsing)), the tabs of a [contextual identity](/en-US/docs/Mozilla/Add-ons/WebExtensions/Work_with_contextual_identities), or a combination of these.
  - `css` {{optional_inline}}
  - : An array of objects. Each object has either a property named `file`, which is a URL starting at the extension's manifest.json and pointing to a CSS file to register, or a property named `code`, which is some CSS code to register.
  - `excludeGlobs` {{optional_inline}}

diff --git a/files/en-us/mozilla/add-ons/webextensions/api/proxy/settings/index.md b/files/en-us/mozilla/add-ons/webextensions/api/proxy/settings/index.md
@@ -16,7 +16,7 @@ browser-compat: webextensions.api.proxy.settings
 
 A {{WebExtAPIRef("types.BrowserSetting", "BrowserSetting")}} object that can be used to change the browser's proxy settings.
 
-> **Note:** The ability to change proxy settings requires private window access because proxy settings affect both private and non-private windows. Therefore, if an extension has not been granted private window permission, calls to `proxy.settings.set()` will throw an exception.
+> **Note:** Changing proxy settings requires private browsing window access because proxy settings affect private and non-private windows. Whether an extension can access private browsing windows is under user control. For details, see [Extensions in Private Browsing](https://support.mozilla.org/en-US/kb/extensions-private-browsing). Your extension can check whether it can access private browsing windows using {{WebExtAPIRef("extension.isAllowedIncognitoAccess")}}. If your extension does not have private window permission, calls to `proxy.settings.set()` throw an exception.
 
 The underlying value is an object with the properties listed below.
 

diff --git a/files/en-us/mozilla/add-ons/webextensions/api/userscripts/register/index.md b/files/en-us/mozilla/add-ons/webextensions/api/userscripts/register/index.md
@@ -42,7 +42,7 @@ await registeredUserScript.unregister();
  - `allFrames` {{Optional_Inline}}
  - : Same as `all_frames` in the [`content_scripts`](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts) key.
  - `cookieStoreId` {{optional_inline}}
- - : An array of cookie store ID strings or a string containing a cookie store ID. Registers the user script in the tabs that belong to the cookie store IDs. This enables scripts to be registered for all default or non-contextual identity tabs, private browsing tabs (if extensions are enabled in private browsing), the tabs of a [contextual identity](/en-US/docs/Mozilla/Add-ons/WebExtensions/Work_with_contextual_identities), or a combination of these.
+ - : An array of cookie store ID strings or a string containing a cookie store ID. Registers the user script in the tabs that belong to the cookie store IDs. This enables scripts to be registered for all default or non-contextual identity tabs, private browsing tabs (if the [extension is enabled in private browsing](https://support.mozilla.org/en-US/kb/extensions-private-browsing)), the tabs of a [contextual identity](/en-US/docs/Mozilla/Add-ons/WebExtensions/Work_with_contextual_identities), or a combination of these.
  - `excludeGlobs` {{Optional_Inline}}
  - : Same as `exclude_globs` in the [`content_scripts`](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/content_scripts) key.
  - `excludeMatches` {{Optional_Inline}}