Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Details of declarativeNetPequest permission notifications #38667

Merged
merged 4 commits into from
Mar 18, 2025
+1 −1
Merged

Details of declarativeNetPequest permission notifications #38667

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
cfba4eb
Details of declarativeNetPequest permission notifications
rebloor Mar 16, 2025
4b58f30
Update following feedback
rebloor Mar 17, 2025
13a3799
Update from feedback
rebloor Mar 18, 2025
6adfbee
Merge branch 'main' into Clarification-of-declarativeNetPequest-permi…
rebloor Mar 18, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Update from feedback 
Co-authored-by: Rob Wu <rob@robwu.nl>
@rebloor @Rob--W
rebloor and Rob--W authored Mar 18, 2025
commit 13a379997dafa005bd46cc5a00e97e71f4c04279
2 changes: 1 addition & 1 deletion files/en-us/mozilla/add-ons/webextensions/api/declarativenetrequest/index.md
View file
Original file line number Diff line number Diff line change
@@ -11,7 +11,7 @@ This API enables extensions to specify conditions and actions that describe how

## Permissions

To use this API, an extension must request the `"declarativeNetRequest"` or `"declarativeNetRequestWithHostAccess"` [permission](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) in its [`manifest.json`](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json) file. The `"declarativeNetRequest"` is notified to users during initial installation and, when added to an installed extension, updates. `"declarativeNetRequestWithHostAccess"` isn't notified to users, as it relies on host permissions.
To use this API, an extension must request the `"declarativeNetRequest"` or `"declarativeNetRequestWithHostAccess"` [permission](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions) in its [`manifest.json`](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json) file. The `"declarativeNetRequest"` permission is shown to users in permission prompts, the `"declarativeNetRequestWithHostAccess"` is not.

The `"declarativeNetRequest"` permission allows extensions to block and upgrade requests without any [host permissions](/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions#host_permissions). Host permissions are required if the extension wants to redirect requests or modify headers on requests or when the `"declarativeNetRequestWithHostAccess"` permission is used instead of the `"declarativeNetRequest"` permission. To act on requests in these cases, host permissions are required for the request URL. For all requests, except for navigation requests (i.e., resource type `main_frame` and `sub_frame`), host permissions are also required for the request's initiator. The initiator of a request is usually the document or worker that triggered the request.