| Index: chrome/common/extensions/docs/static/privacy.html
|
| diff --git a/chrome/common/extensions/docs/static/privacy.html b/chrome/common/extensions/docs/static/privacy.html
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..3b8696ef8e674b2750b5527fad0dcff095b30aaf
|
| --- /dev/null
|
| +++ b/chrome/common/extensions/docs/static/privacy.html
|
| @@ -0,0 +1,73 @@
|
| +<div id="pageData-name" class="pageData">Privacy</div>
|
| +
|
| +<!-- BEGIN AUTHORED CONTENT -->
|
| +<p id="classSummary">
|
| + Use the <code>chrome.privacy</code> module to control usage of the features in
|
| + Chrome that can affect a user's privacy. This module relies on the
|
| + <a href="types.html#ChromeSetting">ChromeSetting prototype of the type API</a>
|
| + for getting and setting Chrome's configuration.
|
| +</p>
|
| +
|
| +<p class="note">
|
| + The <a href="http://www.google.com/intl/en/landing/chrome/google-chrome-privacy-whitepaper.pdf">Chrome Privacy Whitepaper</a>
|
| + gives background detail regarding the features which this API can control.
|
| +</p>
|
| +
|
| +<h2 id="manifest">Manifest</h2>
|
| +<p>
|
| + You must declare the "privacy" permission in your extension's
|
| + <a href="manifest.html"> manifest</a> to use the API. For example:
|
| +</p>
|
| +
|
| +<pre>{
|
| + "name": "My extension",
|
| + ...
|
| + <b>"permissions": [
|
| + "privacy"
|
| + ]</b>,
|
| + ...
|
| +}</pre>
|
| +
|
| +<h2 id="usage">Usage</h2>
|
| +
|
| +<p>
|
| + Reading the current value of a setting is straightforward. You'll first need
|
| + to find the property you're interested in, then you'll call <code>get()</code>
|
| + on that object in order to retrieve it's current value and your extension's
|
| + level of control. For example, to determine if Chrome's Autofill feature is
|
| + enabled, you'd write:
|
| +</p>
|
| +
|
| +<pre>chrome.privacy.services.autofillEnabled.get({}, function(details) {
|
| + if (details.value)
|
| + console.log('Autofill is on!');
|
| + else
|
| + console.log('Autofill is off!');
|
| +});</pre>
|
| +
|
| +<p>
|
| + Changing the value of a setting is a little bit more complex, simply because
|
| + you first must verify that your extension can control the setting. If the
|
| + setting has been locked down by enterprise policy, or already been set by
|
| + another extension, then your extension will be denied write access. You'll
|
| + use the <code>get()</code> method to determine your level of access, and then
|
| + call <code>set()</code> if your extension can grab control over the setting:
|
| +</p>
|
| +
|
| +<pre>chrome.privacy.services.autofillEnabled.get({}, function(details) {
|
| + if (details.levelOfControl === 'controllable_by_this_extension') {
|
| + chrome.privacy.services.autofillEnabled.set({ value: true }, function() {
|
| + if (chrome.extension.lastError === undefined)
|
| + console.log("Hooray, it worked!");
|
| + else
|
| + console.log("Sadness!", chrome.extension.lastError);
|
| + }
|
| + }
|
| +});</pre>
|
| +
|
| +<h2 id="examples">Examples</h2>
|
| +<p>
|
| + For example code, see the
|
| + <a href="samples.html#privacy">Privacy API samples</a>.
|
| +</p>
|
| +<!-- END AUTHORED CONTENT -->
|
|
|