mirror of
https://github.com/mdn/webextensions-examples.git
synced 2026-04-16 14:28:33 +02:00
06330a69c2
These examples are designed to be cross-browser compatible. In particular, these extensions do not use `background` because there is currently no single manifest that can support both Firefox and Chrome, due to the lack of event page support in Chrome, and the lack of service worker support in Firefox. Three examples demonstrating the use of the declarativeNetRequest API: - dnr-block-only: One minimal example demonstrating the use of static DNR rules to block requests. - dnr-redirect-url: One minimal example demonstrating the use of static DNR rules to redirect requests. - dnr-dynamic-with-options: A generic example demonstrating how host permissions can be requested and free forms to input DNR rules.
98 lines
2.4 KiB
HTML
98 lines
2.4 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<style>
|
|
div {
|
|
margin: 2px 0;
|
|
border: 1px solid black;
|
|
}
|
|
img {
|
|
display: block;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
|
|
<h2 id="blocksub">Block requests containing 'blocksub' (except main_frame)</h2>
|
|
Given the following rule:
|
|
<pre>
|
|
{
|
|
"id": 1,
|
|
"condition": {
|
|
"urlFilter": "blocksub"
|
|
},
|
|
"action": {
|
|
"type": "block"
|
|
}
|
|
},
|
|
</pre>
|
|
<div>
|
|
rule 1 will block this image (containing 'blocksub'):
|
|
<img src="https://developer.mozilla.org/favicon.ico?blocksub">
|
|
</div>
|
|
<div>
|
|
rule 1 will not block this image (does not contain 'blocksub'):
|
|
<img src="https://developer.mozilla.org/favicon.ico">
|
|
</div>
|
|
<div>
|
|
rule 1 will not block top-level navigations to
|
|
<a href="https://developer.mozilla.org/favicon.ico?blocksub">https://developer.mozilla.org/favicon.ico?blocksub</a>
|
|
because top-level navigation ("main_frame") requests are not matched
|
|
when "resourceTypes" and "excludedResourceTypes" are not specified.
|
|
</div>
|
|
|
|
<h2 id="blocktop">Block main_frame requests containing 'blocktop'</h2>
|
|
Given the following rule:
|
|
<pre>
|
|
{
|
|
"id": 2,
|
|
"condition": {
|
|
"urlFilter": "blocktop",
|
|
"resourceTypes": ["main_frame"]
|
|
},
|
|
"action": {
|
|
"type": "block"
|
|
}
|
|
},
|
|
</pre>
|
|
<div>
|
|
rule 2 will block top-level navigation to
|
|
<a href="https://developer.mozilla.org/favicon.ico?blocktop">https://developer.mozilla.org/favicon.ico?blocktop</a>
|
|
because the "resourceTypes" array contains "main_frame".
|
|
</div>
|
|
<div>
|
|
rule 2 will not block this image (containing 'blocktop')
|
|
<img src="https://developer.mozilla.org/favicon.ico?blocktop">
|
|
because "image" is not in the "resourceTypes" array.
|
|
</div>
|
|
|
|
<h2 id="blockall">Block all requests containing 'blockall'</h2>
|
|
Given the following rule:
|
|
<pre>
|
|
{
|
|
"id": 3,
|
|
"condition": {
|
|
"urlFilter": "blockall",
|
|
"excludedResourceTypes": []
|
|
},
|
|
"action": {
|
|
"type": "block"
|
|
}
|
|
}
|
|
</pre>
|
|
<div>
|
|
rule 3 will block this image (containing 'blockall'):
|
|
<img src="https://developer.mozilla.org/favicon.ico?blockall">
|
|
</div>
|
|
<div>
|
|
rule 3 will block top-level navigation to
|
|
<a href="https://developer.mozilla.org/favicon.ico?blockall">https://developer.mozilla.org/favicon.ico?blockall</a>
|
|
because "excludedResourceTypes" is set to an empty array.
|
|
<br>
|
|
Note: not blocked in Chrome due to <a href="https://crbug.com/1432871">https://crbug.com/1432871</a>.
|
|
</div>
|
|
|
|
</body>
|
|
</html>
|