Stay organized with collections Save and categorize content based on your preferences.
Chrome extensions enhance the user's browser experience. To do this extensions use Chrome APIs that require certain permissions. Some permissions are less intrusive and don't display a warning. Other permissions trigger a warning that users have to allow. This page provides guidelines for working with permission warnings. Specific warnings are noted in the Permissions under the permission to which they apply.
Figure 1: Permission warnings dialog displayed on installation.When a new permission that triggers a warning is added, the extension will be disabled until the user accepts the new permission. See Updating permissions to learn how to test this behavior.
Figure 2: An extension that is disabled until the user accepts the new permission.Some permissions may not display warnings when paired with other permissions. For example, the "tabs"
warning won't show if the extension also requests "<all_urls>"
.
Permission warnings describe the capabilities an API grants, but some warnings are harder to understand than others. Users are more likely to install extensions that follow these guidelines:
To view an extension's permission warnings, you have the following options:
Use the Extension Update Testing ToolBefore you begin
npm install
in the root of the repository.Using the tool
npm start
.chrome://extensions
Click the Pack Extension button.
Figure 4: Specifying Extension PathChrome will create two files, a .crx
file and a .pem
file. The .pem
file contains the private key used to sign the extension. Make sure you remember which directory these files were saved.
Keep the .pem
file in a secret and secure place; it will be needed to update the extension.
Install the .crx
file by dropping it into the Extension's Management page.
After dropping the .crx
file the browser will ask if the extension can be added and display warnings.
When an extension adds a new permission that triggers a warning it may temporarily disable it. The extension will be re-enabled only after the user agrees to accept the new permission.
To check if your extension will be disabled when adding a new permission, you have the following options:
Update using the Extension Update Testing ToolThese steps assume you followed the Using the Extension Update Testing Tool instructions to start the server.
Using the tool
chrome://extensions
..crx
file you just created in View Warnings.manifest.json
and add any permission that triggers a warning.chrome://extensions
. Do not remove the previously installed package.You will see a dialog that prompts the user to accept the new permissions.
Figure 9: Disabled extension warning Figure 10: Requesting new permission dialogExcept as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-02-05 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-02-05 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4