0Pricing
Browser Extensions Development (Chrome & Edge) · Aula

Permissões e Correspondência de Hosts

Entenda como declarar e solicitar as permissões necessárias e como as permissões de host controlam o acesso aos sites.

Permissões e Correspondência de Hosts é uma aula grátis de Browser Extensions Development (Chrome & Edge) no CoddyKit. Esta é a aula 3 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.

Why Extensions Need Permissions

Just like apps on your phone, browser extensions often need special 'permissions' to do their job. These permissions define what your extension can and cannot do.

This system is crucial for user security and privacy. It prevents extensions from accessing information or performing actions they don't need, without your explicit consent.

Two Core Permission Types

In Manifest V3, permissions generally fall into two categories:

  • API Permissions: Access to specific browser features (e.g., managing tabs, saving data).
  • Host Permissions: Access to specific websites (e.g., reading content on example.com).

We'll look at how to declare both in your manifest.json file.

Declaring API Permissions

API permissions are listed under the "permissions" key in your manifest.json. Each string in the array corresponds to a specific browser API.

For example, "storage" lets your extension save user data, and "tabs" allows it to interact with browser tabs (like getting their URLs).

{
  "manifest_version": 3,
  "name": "My Extension",
  "version": "1.0",
  "permissions": [
    "storage",
    "tabs"
  ]
}

The 'activeTab' Permission

The "activeTab" permission is unique. It's an API permission that grants your extension temporary host permissions to the currently active tab.

This access is granted only when the user *invokes* your extension (e.g., clicks its toolbar icon). It's a great way to reduce initial permission warnings, as access is only given when needed.

{
  "manifest_version": 3,
  "name": "ActiveTab Demo",
  "version": "1.0",
  "permissions": [
    "activeTab"
  ]
}

Understanding Host Permissions

Host permissions are crucial for defining which websites your extension can interact with. Without them, your extension cannot read or modify content on web pages.

This is a major security boundary. An extension with host permission for google.com cannot access facebook.com, protecting user data and ensuring privacy.

Specifying Host Permissions

Host permissions are declared in the "host_permissions" array in your manifest.json. You use URL match patterns to specify the domains.

A match pattern like "*://*.example.com/*" means access to all subdomains of example.com over HTTP or HTTPS.

{
  "manifest_version": 3,
  "name": "Host Access",
  "version": "1.0",
  "host_permissions": [
    "*://developer.chrome.com/*",
    "https://www.example.org/*"
  ]
}

Match Pattern Wildcards

Match patterns use special characters:

  • *: Matches any string (except / in scheme/host, or # in path).
  • <all_urls>: A special pattern that matches any URL (http, https, ftp, file). Use this with extreme caution as it grants wide access.

For example, "https://*.google.com/search?*" would match Google search results pages.

Combining API & Host Permissions

Often, your extension will need both API and host permissions. Here's an example for an extension that wants to execute a script on Wikipedia pages.

It needs the "scripting" API permission to run code, and host permission for Wikipedia to define where that code can run.

{
  "manifest_version": 3,
  "name": "Wiki Enhancer",
  "version": "1.0",
  "permissions": [
    "scripting"
  ],
  "host_permissions": [
    "*://*.wikipedia.org/*"
  ]
}

User Consent & Trust

When a user installs your extension, the browser displays a list of all requested permissions. This is their chance to understand what your extension can do.

Always request the minimum necessary permissions. Over-requesting can make users distrust your extension and choose not to install it. Be transparent!

Check Your Understanding

Which statements accurately describe host permissions in Manifest V3 extensions?

Permissions & Host Matching Recap

Great job! You've learned about the vital role of permissions in Manifest V3 extensions.

  • API Permissions: Access browser features (e.g., "storage", "tabs").
  • Host Permissions: Control website access using URL match patterns (e.g., "*://*.google.com/*").
  • "activeTab" is a special API permission that grants temporary host access.
  • Always request the minimum necessary permissions to build user trust.

Understanding these concepts is key to building secure and functional extensions!

Perguntas Frequentes

A aula “Permissões e Correspondência de Hosts” é grátis?

Sim — o texto completo de “Permissões e Correspondência de Hosts” é 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 “Permissões e Correspondência de Hosts”?

Entenda como declarar e solicitar as permissões necessárias e como as permissões de host controlam o acesso aos sites. 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 3 de 4.

Quanto tempo leva a aula “Permissões e Correspondência de Hosts”?

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

  1. Entendendo a Estrutura do Manifest V3
  2. Trabalhadores de Serviço em Segundo Plano
  3. Permissões e Correspondência de Hosts
  4. Ação, Ícones e o Botão da Barra de Ferramentas
← Voltar para Browser Extensions Development (Chrome & Edge)