Browser Extensions Development (Chrome & Edge) · Aula

Injeção de Scripts de Conteúdo

Aprenda a injetar JavaScript e CSS em páginas web específicas, permitindo que sua extensão modifique a aparência e o comportamento delas.

Injeção de Scripts de Conteúdo é uma aula grátis de Browser Extensions Development (Chrome & Edge) no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Browser Extensions Development (Chrome & Edge), e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Browser Extensions Development (Chrome & Edge) inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

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 the chrome.scripting API 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.json for 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!

Perguntas Frequentes

A aula “Injeção de Scripts de Conteúdo” é grátis?

Sim — o texto completo de “Injeção de Scripts de Conteúdo” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Browser Extensions Development (Chrome & Edge), atualize para CoddyKit PRO. O curso de Browser Extensions Development (Chrome & Edge) inclui 4 aulas no total.

O que vou aprender em “Injeção de Scripts de Conteúdo”?

Aprenda a injetar JavaScript e CSS em páginas web específicas, permitindo que sua extensão modifique a aparência e o comportamento delas. Você pratica Browser Extensions Development (Chrome & Edge) com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Browser Extensions Development (Chrome & Edge)?

Nenhuma experiência prévia é necessária. Browser Extensions Development (Chrome & Edge) no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.

Quanto tempo leva a aula “Injeção de Scripts de Conteúdo”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Browser Extensions Development (Chrome & Edge)?

Sim. Cada aula de Browser Extensions Development (Chrome & Edge) inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Browser Extensions Development (Chrome & Edge)