Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(523)

Side by Side Diff: chrome/common/extensions/docs/static/preferences.html

Issue 7065033: Support persistent incognito preferences (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src
Patch Set: Fixed a unit test Created 9 years, 7 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
1 <div id="pageData-name" class="pageData">Preferences</div> 1 <div id="pageData-name" class="pageData">Preferences</div>
2 2
3 <!-- BEGIN AUTHORED CONTENT --> 3 <!-- BEGIN AUTHORED CONTENT -->
4 <p id="classSummary"> 4 <p id="classSummary">
5 The <code>chrome.preferences</code> module contains a prototype for giving other 5 The <code>chrome.preferences</code> module contains a prototype for giving other
6 modules access to manage preferences stored by Chrome. This prototype is used 6 modules access to manage Chrome's preferences. This prototype is used for
7 for example for <a 7 example for <a
8 href="proxy.html#property-settings"><code>chrome.proxy.settings</code></a>. 8 href="proxy.html#property-settings"><code>chrome.proxy.settings</code></a>.
9 </p> 9 </p>
10 10
11 <h2 id="description">Overview</h2> 11 <h2 id="description">Functions</h2>
12 12
13 <p> 13 <p>
14 The preferences API provides a common set of functions 14 The preferences API provides a commen set of functions
15 (<code>getEffective()</code>, <code>set()</code>, and <code>clear()</code>) as 15 (<code>getEffective()</code>, <code>set()</code>, and <code>clear()</code>) as
16 well as an event publisher (<code>onChangeEffective</code>) for various 16 well as an event publisher (<code>onChangeEffective</code>) for various
17 preferences in Chrome. The <a href="proxy.html#overview-examples">proxy settings 17 preferences in Chrome. The <a href="proxy.html#overview-examples">proxy settings
18 examples</a> demonstrate how these functions are intended to be used. 18 examples</a> demonstrate how these functions are intended to be used.
19 </p> 19 </p>
20 20
21 <!--
22 <h2 id="lifecycle">Life cycle of preferences</h2> 21 <h2 id="lifecycle">Life cycle of preferences</h2>
23 22
24 <p> 23 <p>
25 The life cycle of preferences depends on whether they are set for regular or 24 The life cycle of preferences depends on whether they are set for regular or
26 incognito profiles. </p> 25 incognito profiles. Currently, preferences can only be set for regular profiles.
27 --> 26 </p>
28 27
29 <p> 28 <p>
30 Currently, preferences can only be set for regular profiles. Once set, they 29 Preferences for <em>regular profiles</em> are persisted to disk. Once set, they
31 remain in place until they are cleared by the governing extension, or the 30 remain in place until they are cleared by the governing extension, or the
32 governing extension is disabled or uninstalled. 31 governing extension is disabled or uninstalled.
33 </p> 32 </p>
34 33
35 <h2 id="precedence">Precedence</h2> 34 <h2 id="precedence">Precedence</h2>
36 35
37 <p> 36 <p>
38 Chrome manages preferences on different layers. The following list describes the 37 Chrome manages preferences on different layers. The following list describes the
39 layers that may influence the effective preferences, in increasing order of 38 layers that may influence the effective preferences, in increasing order of
40 precedence. 39 precedence.
41 <ol> 40 <ol>
42 <li>System preferences provided by the operating system</li> 41 <li>System preferences provided by the operating system</li>
43 <li>Command-line parameters</li> 42 <li>Command line parameters</li>
44 <li>Preferences set by extensions</li> 43 <li>Preferences set by extensions</li>
45 <li>Policies</li> 44 <li>Policies</li>
46 </ol> 45 </ol>
47 </p> 46 </p>
48 47
49 <p> 48 <p>
50 As the list implies, policies might overrule any changes that you specify with 49 As the list implies, policies might overrule any changes that you specify with
51 your extension. 50 your extension.
52 </p> 51 </p>
53 52
(...skipping 13 matching lines...) Expand all
67 <li>If only <b>(I)</b> is set, these preferences are effective for only 66 <li>If only <b>(I)</b> is set, these preferences are effective for only
68 incognito windows. Regular windows use the preferences determined by the lower 67 incognito windows. Regular windows use the preferences determined by the lower
69 layers (command-line options and system settings).</li> 68 layers (command-line options and system settings).</li>
70 <li>If both <b>(R)</b> and <b>(I)</b> are set, the respective preferences are 69 <li>If both <b>(R)</b> and <b>(I)</b> are set, the respective preferences are
71 used for regular and incognito windows.</li> 70 used for regular and incognito windows.</li>
72 </ul> 71 </ul>
73 </p> 72 </p>
74 --> 73 -->
75 74
76 <p> 75 <p>
77 If two or more extensions want to set the same preference to different values, 76 If two extensions want to set the same preference to different values, the
78 the extension installed most recently takes precedence over the other 77 extension installed last takes precedence over the other extensions.
79 extensions.
80 <!-- If the 78 <!-- If the
81 extension installed last sets only <b>(I)</b>, the preference of regular windows 79 extension installed last sets only <b>(I)</b>, the preference of regular windows
82 can be defined by previously installed extensions. --> 80 can be defined by previously installed extensions. -->
83 </p> 81 </p>
84 82
85 <p> 83 <p>
86 The <em>effective</em> preference value is the setting that results from 84 The <em>effective</em> preference value is the setting that results from
87 considering the preference rules. It is used by Chrome. 85 considering the preference rules. It is used by Chrome.
88 <p> 86 <p>
89 87
90 <!-- END AUTHORED CONTENT --> 88 <!-- END AUTHORED CONTENT -->
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698