Расширенные разрешения
Изучите чувствительные разрешения, такие как `activeTab`, `scripting` и разрешения для узлов, а также узнайте, когда и как их запрашивать.
«Расширенные разрешения» — бесплатный урок Browser Extensions Development (Chrome & Edge) на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Browser Extensions Development (Chrome & Edge), и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Browser Extensions Development (Chrome & Edge) содержит 4 уроков всего.
Части этого урока еще не переведены и отображаются на английском.
Beyond Basic Permissions
Welcome! In this lesson, we'll dive into advanced browser extension permissions. These permissions grant powerful capabilities, allowing your extension to interact more deeply with web content and user data.
Understanding them is crucial for building robust extensions while maintaining user trust and security.
We'll cover:
- Host Permissions
activeTabPermissionscriptingPermission
Granting Web Access
Host permissions are fundamental. They define which websites your extension can interact with. This includes reading data, modifying content, or making network requests on those specific sites.
Think of them as "keys" that unlock access to certain web domains.
Manifesting Host Access
You declare host permissions in your manifest.json file under the host_permissions key. Each string is a URL pattern.
For instance, to allow access to all pages on google.com, you'd specify:
{
"name": "My Extension",
"version": "1.0",
"manifest_version": 3,
"host_permissions": [
"https://www.google.com/*"
]
}Broad Access with Wildcards
You can use wildcards (*) for broader access. For example, "<all_urls>" (or "*://*/*") grants access to all URLs, on all schemes (HTTP, HTTPS).
While powerful, using broad wildcards should be done with extreme caution, as it grants your extension significant control over the user's browsing experience on any site.
{
"name": "My Extension",
"version": "1.0",
"manifest_version": 3,
"host_permissions": [
"<all_urls>"
]
}Temporary Tab Privileges
The activeTab permission is a safer alternative to broad host permissions for one-off actions on the current page.
When the user invokes your extension (e.g., clicks its icon), activeTab grants your extension temporary host permissions to the currently active tab. These permissions last until the user navigates away or closes the tab.
{
"name": "My Extension",
"version": "1.0",
"manifest_version": 3,
"permissions": [
"activeTab"
]
}Getting Current Tab URL
With activeTab, your extension can access information about the current tab, like its URL or title, without needing permanent host permissions.
Try running this example. Imagine this code is in your extension's popup script:
// This script runs when the extension popup opens.
document.addEventListener('DOMContentLoaded', function() {
chrome.tabs.query({ active: true, currentWindow: true }, function(tabs) {
if (tabs.length > 0) {
const activeTab = tabs[0];
console.log('Active tab URL:', activeTab.url);
// Display in popup for demonstration
document.body.innerHTML = `<p>Current URL: ${activeTab.url}</p>`;
} else {
document.body.innerHTML = `<p>No active tab.</p>`;
}
});
});Programmatic Code Injection
The scripting permission allows your extension to programmatically inject JavaScript and CSS into web pages. This is how you modify a page's content or behavior.
It's an essential permission for content scripts, replacing the Manifest V2 tabs.executeScript API.
{
"name": "My Extension",
"version": "1.0",
"manifest_version": 3,
"permissions": [
"scripting"
],
"host_permissions": [
"https://www.example.com/*"
]
}Modifying a Page
Once you have scripting permission (and host permission for the target tab), you can inject code. This example injects a simple script to change the background color of the active tab.
Imagine this running in your background script or popup:
// This code would typically run from a background script
// or popup after a user action.
chrome.tabs.query({ active: true, currentWindow: true }, function(tabs) {
if (tabs.length > 0) {
const activeTabId = tabs[0].id;
chrome.scripting.executeScript({
target: { tabId: activeTabId },
function: () => {
// This function runs in the context of the web page
document.body.style.backgroundColor = 'lightblue';
console.log('CoddyKit: Page background changed!');
}
});
}
});Least Privilege Principle
Always follow the Principle of Least Privilege: request only the permissions your extension absolutely needs.
- Required Permissions: Declared in
manifest.jsonand requested at install. - Optional Permissions: Can be requested at runtime using
chrome.permissions.request()only when the user needs that specific feature. This gives users more control and builds trust.
Permission Scenarios
Which permission(s) would you need for an extension that, when its icon is clicked, reads the current page's title and then injects a custom CSS file into that same page?
Advanced Permissions Summary
Great job! You've learned about powerful advanced permissions:
- Host Permissions: Grant access to specific websites.
activeTab: Provides temporary host permissions to the active tab upon user invocation, ideal for one-off actions.scripting: Enables programmatic injection of JavaScript and CSS.
Always use the least privileged approach to ensure security and user trust. Next, we'll explore secure coding practices!
Часто задаваемые вопросы
Урок «Расширенные разрешения» бесплатный?
Да — полный текст урока «Расширенные разрешения» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Browser Extensions Development (Chrome & Edge), подпишись на CoddyKit PRO. Курс Browser Extensions Development (Chrome & Edge) содержит 4 уроков всего.
Чему я научусь в уроке «Расширенные разрешения»?
Изучите чувствительные разрешения, такие как `activeTab`, `scripting` и разрешения для узлов, а также узнайте, когда и как их запрашивать. Ты практикуешь Browser Extensions Development (Chrome & Edge) с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать Browser Extensions Development (Chrome & Edge)?
Предыдущий опыт не требуется. Browser Extensions Development (Chrome & Edge) на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.
Сколько времени занимает урок «Расширенные разрешения»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке Browser Extensions Development (Chrome & Edge)?
Да. Каждый урок Browser Extensions Development (Chrome & Edge) включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Расширенные разрешения
- Методы безопасного программирования
- Политика безопасности содержимого (CSP)
- Необязательные разрешения и запросы во время выполнения