OLD | NEW |
1 <h1 id="incognito">Manifest - Incognito</h1> | 1 <h1 id="incognito">Manifest - Incognito</h1> |
2 | 2 |
3 <p> | 3 <p> |
4 Use the <code>"incognito"</code> manifest key with either | 4 Use the <code>"incognito"</code> manifest key with either |
5 <code>"spanning"</code> or <code>"split"</code> to specify how this | 5 <code>"spanning"</code> or <code>"split"</code> to specify how this |
6 {{platform}} will behave if allowed to run in incognito mode. | 6 {{platform}} will behave if allowed to run in incognito mode. Using <code> |
| 7 "not_allowed"</code> to prevent this {{platform}} from being enabled in |
| 8 incognito mode. |
7 </p> | 9 </p> |
8 | 10 |
9 <p> | 11 <p> |
10 Only extensions can choose. Apps will always use the default value for the app | 12 Only extensions can choose. Apps will always use the default value for the app |
11 type; <code>"spanning"</code> for Chrome apps and <code>"split"</code> for | 13 type; <code>"spanning"</code> for Chrome apps and <code>"split"</code> for |
12 installable web and legacy packaged apps. | 14 installable web and legacy packaged apps. |
13 </p> | 15 </p> |
14 | 16 |
15 <h2 id="spanning">Spanning mode</h2> | 17 <h2 id="spanning">Spanning mode</h2> |
16 <p> | 18 <p> |
(...skipping 11 matching lines...) Expand all Loading... |
28 The default for installable web apps and legacy packaged apps is | 30 The default for installable web apps and legacy packaged apps is |
29 <code>"split"</code>, which means that all app pages in an incognito window | 31 <code>"split"</code>, which means that all app pages in an incognito window |
30 will run in their own incognito process. If the app or extension contains a | 32 will run in their own incognito process. If the app or extension contains a |
31 background page, that will also run in the incognito process. This incognito | 33 background page, that will also run in the incognito process. This incognito |
32 process runs along side the regular process, but has a separate memory-only | 34 process runs along side the regular process, but has a separate memory-only |
33 cookie store. Each process sees events and messages only from its own context | 35 cookie store. Each process sees events and messages only from its own context |
34 (for example, the incognito process will see only incognito tab updates). The | 36 (for example, the incognito process will see only incognito tab updates). The |
35 processes are unable to communicate with each other. | 37 processes are unable to communicate with each other. |
36 </p> | 38 </p> |
37 | 39 |
| 40 <h2 id="not_allowed">Not allowed</h2> |
| 41 <p> |
| 42 The {{platform}} cannot be enabled in incognito mode. Available from Chrome 47. |
| 43 </p> |
| 44 |
38 <h2 id="how-to-choose">How to choose</h2> | 45 <h2 id="how-to-choose">How to choose</h2> |
39 <p> | 46 <p> |
40 As a rule of thumb, if your extension or app needs to load a tab in an | 47 As a rule of thumb, if your extension or app needs to load a tab in an |
41 incognito browser, use <em>split</em> incognito behavior. If your extension or | 48 incognito browser, use <em>split</em> incognito behavior. If your extension or |
42 app needs to be logged into a remote server use <em>spanning</em> incognito | 49 app needs to be logged into a remote server use <em>spanning</em> incognito |
43 behavior. | 50 behavior. |
44 </p> | 51 </p> |
45 | 52 |
46 <p> | 53 <p> |
47 <a href="/{{platform}}s/storage#property-sync">chrome.storage.sync</a> and | 54 <a href="/{{platform}}s/storage#property-sync">chrome.storage.sync</a> and |
48 <a href="/{{platform}}s/storage#property-local">chrome.storage.local</a> | 55 <a href="/{{platform}}s/storage#property-local">chrome.storage.local</a> |
49 are <em>always</em> shared between regular and incognito processes. It is | 56 are <em>always</em> shared between regular and incognito processes. It is |
50 recommended to use them for persisting your {{platform}}'s settings. | 57 recommended to use them for persisting your {{platform}}'s settings. |
51 </p> | 58 </p> |
OLD | NEW |