| OLD | NEW |
| 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 Loading... |
| 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 --> |
| OLD | NEW |