mirror of
https://github.com/GoogleChrome/chrome-extensions-samples.git
synced 2026-03-27 13:29:34 +07:00
45d8850c1a
* Add declarativeNetRequest API samples. Adds a number of samples for the declarativeNetRequest API.
25 lines
1.3 KiB
Markdown
25 lines
1.3 KiB
Markdown
# chrome.scripting API
|
|
|
|
This sample demonstrates using the [chrome.scripting](https://developer.chrome.com/docs/extensions/reference/scripting/) API to inject JavaScript into web pages.
|
|
|
|
## Overview
|
|
|
|
Once this extension is installed, clicking this extension's action icon will open an extension page.
|
|
|
|
<img src="screenshot.png" height=300 alt="Screenshot showing the chrome.scripting API demo running in Chrome.">
|
|
|
|
## Features
|
|
|
|
This sample allows you to experiment with the following injection mechanisms:
|
|
|
|
- [Dynamic Declarations](https://developer.chrome.com/docs/extensions/mv3/content_scripts/#dynamic-declarative), where a content script is registered at runtime.
|
|
- [Programmatic Injection](https://developer.chrome.com/docs/extensions/mv3/content_scripts/#programmatic), where a script is programatically executed in a tab which is already open.
|
|
|
|
Learn more at https://developer.chrome.com/docs/extensions/mv3/content_scripts/.
|
|
|
|
## Implementation Notes
|
|
|
|
Programmatic injection is handled in the service worker. A tab is opened to a specific URL (https://example.com/#inject-programmatic). When the page finishes loading, a script is then run using `chrome.scripting.executeScript`.
|
|
|
|
When registering a dynamic content script, a tab is automatically opened if using the default matches URL. Otherwise, no tab is opened and the correct URL needs to be manually navigated to.
|