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