Injecter des scripts de contenu
Apprenez à injecter JavaScript et CSS dans des pages Web spécifiques afin que votre extension puisse modifier leur apparence et leur comportement.
Injecter des scripts de contenu est une leçon Browser Extensions Development (Chrome & Edge) gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Browser Extensions Development (Chrome & Edge), et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Browser Extensions Development (Chrome & Edge) comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
What are Content Scripts?
Welcome to Content Scripts! These are JavaScript files that run in the context of web pages loaded in the browser.
Think of them as a bridge. They allow your extension to interact with the web page's content, just like a script running directly on that page.
- Read details from a page.
- Modify the page's appearance.
- Add or remove elements.
The Isolated World
Content scripts run in an 'isolated world'. This means they don't interfere with the page's own JavaScript environment.
Your script can access and modify the page's Document Object Model (DOM), but it can't directly access JavaScript variables or functions defined by the web page itself.
This isolation prevents conflicts and ensures your extension doesn't break the web page's functionality.
Static Injection via manifest.json
The simplest way to inject content scripts is by declaring them in your extension's manifest.json file.
These scripts will automatically load and run on web pages that match the patterns you specify. It's great for scripts that need to be active whenever a certain type of page loads.
Static JS Injection Example
Here's how you'd set up a content script in your manifest.json to inject a JavaScript file called content.js:
{ "manifest_version": 3,
"name": "My Page Modifier",
"version": "1.0",
"content_scripts": [
{
"matches": ["https://*.example.com/*"],
"js": ["content.js"]
}
]
}Static CSS Injection Example
You can also inject CSS files using the same content_scripts field in your manifest.json. This is perfect for custom styling!
The CSS will apply to matching pages, modifying their visual appearance.
{ "manifest_version": 3,
"name": "My Page Styler",
"version": "1.0",
"content_scripts": [
{
"matches": ["*://*.google.com/*"],
"css": ["content.css"]
}
]
}Programmatic Injection
Sometimes you need more control over when a script is injected. This is where programmatic injection comes in.
You can inject scripts dynamically based on user actions (like clicking a button in your popup) or specific conditions, rather than automatically on page load.
Using chrome.scripting.executeScript()
To inject scripts programmatically, you use the chrome.scripting.executeScript() API from your extension's background script or popup.
This method requires the scripting permission in your manifest.json.
- It targets a specific tab.
- You can inject a function or a file.
- Perfect for on-demand interactions.
Programmatic Code Demo
This example shows a background script injecting a simple function into the active tab when the extension icon is clicked.
The injected function changes the page's background color. Try running it!
// manifest.json snippet:
// {"permissions": ["activeTab", "scripting"]}
// background.js
chrome.action.onClicked.addListener(async (tab) => {
if (tab.url.startsWith("http")) {
await chrome.scripting.executeScript({
target: { tabId: tab.id },
function: () => {
document.body.style.backgroundColor = 'lightblue';
console.log('Background changed!');
}
});
}
});Permissions & Best Practices
For programmatic injection, you'll typically need the activeTab and scripting permissions.
activeTab: Grants temporary host permissions to the currently active tab when the user invokes the extension.scripting: Allows using thechrome.scriptingAPI to inject code.
Always request the minimum necessary permissions for your extension's functionality.
Quick Check
Which of the following statements about content scripts is TRUE?
Recap: Injecting Content Scripts
You've learned how to inject content scripts into web pages!
- Content scripts let your extension interact with web pages.
- They run in an isolated world to prevent conflicts.
- You can inject them statically via
manifest.jsonfor automatic loading. - Or, inject them programmatically using
chrome.scripting.executeScript()for on-demand actions.
Next, we'll dive into how to modify the DOM of web pages using these powerful scripts!
Questions Fréquemment Posées
La leçon « Injecter des scripts de contenu » est-elle gratuite ?
Oui — le texte complet de « Injecter des scripts de contenu » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Browser Extensions Development (Chrome & Edge), passe à CoddyKit PRO. Le cours Browser Extensions Development (Chrome & Edge) comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Injecter des scripts de contenu » ?
Apprenez à injecter JavaScript et CSS dans des pages Web spécifiques afin que votre extension puisse modifier leur apparence et leur comportement. Tu pratiques Browser Extensions Development (Chrome & Edge) avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Browser Extensions Development (Chrome & Edge) ?
Aucune expérience préalable n'est requise. Browser Extensions Development (Chrome & Edge) sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.
Combien de temps prend la leçon « Injecter des scripts de contenu » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Browser Extensions Development (Chrome & Edge) ?
Oui. Chaque leçon Browser Extensions Development (Chrome & Edge) inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Injecter des scripts de contenu
- Modifier le DOM d’une page Web
- Interagir avec les données d’une page Web
- Injecter du CSS et isoler les styles