OLD | NEW |
1 <p>The downloads API allows you to programmatically initiate, monitor, | 1 <p>The downloads API allows you to programmatically initiate, monitor, |
2 manipulate, and search for downloads.</p> | 2 manipulate, and search for downloads.</p> |
| 3 |
3 <h2 id='manifest'>Manifest</h2> | 4 <h2 id='manifest'>Manifest</h2> |
| 5 |
4 <p> You must declare the 'downloads' permission in the <a | 6 <p> You must declare the 'downloads' permission in the <a |
5 href='manifest.html'>extension manifest</a> to use this API, along with <a | 7 href='manifest.html'>extension manifest</a> to use this API, along with <a |
6 href='manifest.html#permissions'>host permissions</a> for any hosts that you | 8 href='manifest.html#permissions'>host permissions</a> for any hosts that you |
7 may pass to <a href='#method-download'>download()</a>.</p> | 9 may pass to <a href='#method-download'>download()</a>.</p> |
| 10 |
8 <pre>{ | 11 <pre>{ |
9 'name': 'My extension', | 12 'name': 'My extension', |
10 ... | 13 ... |
11 <b> 'permissions': [ | 14 <b> 'permissions': [ |
12 'downloads', | 15 'downloads', |
13 '*://*.google.com' | 16 '*://*.google.com' |
14 ]</b>, | 17 ]</b>, |
15 ... | 18 ... |
16 }</pre> | 19 }</pre> |
| 20 |
17 <p>If the URL's hostname is not specified in the permissions, then <a | 21 <p>If the URL's hostname is not specified in the permissions, then <a |
18 href='#method-download'>download()</a> will call its callback with a null | 22 href='#method-download'>download()</a> will call its callback with a null |
19 <code>downloadId</code> and set the <a | 23 <code>downloadId</code> and set the <a |
20 href='extension.html#property-lastError'>chrome.extensions.lastError</a> | 24 href='extension.html#property-lastError'>chrome.extensions.lastError</a> |
21 object to indicate that the extension does not have permission to access that | 25 object to indicate that the extension does not have permission to access that |
22 hostname.</p> | 26 hostname.</p> |
| 27 |
23 <h2 id='examples'>Examples</h2> | 28 <h2 id='examples'>Examples</h2> |
| 29 |
24 <p>You can find simple examples of using the downloads module in the <a | 30 <p>You can find simple examples of using the downloads module in the <a |
25 href='http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extensions/d
ocs/examples/api/downloads/'>examples/api/downloads</a> | 31 href='http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extensions/d
ocs/examples/api/downloads/'>examples/api/downloads</a> |
26 directory. For other examples and for help in viewing the source code, see <a | 32 directory. For other examples and for help in viewing the source code, see <a |
27 href='samples.html'>Samples</a>.</p> | 33 href='samples.html'>Samples</a>.</p> |
OLD | NEW |