chrome.downloads | API | Chrome for Developers

<!doctype html> <html lang="en" dir="ltr"> <head> <meta name="google-signin-client-id" content="157101835696-ooapojlodmuabs2do2vuhhnf90bccmoi.apps.googleusercontent.com"> <meta name="google-signin-scope" content="profile email https://www.googleapis.com/auth/developerprofiles https://www.googleapis.com/auth/developerprofiles.award"> <meta property="og:site_name" content="Chrome for Developers"> <meta property="og:type" content="website"><meta name="theme-color" content="#1a73e8"><meta charset="utf-8"> <meta content="IE=Edge" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="manifest" href="/_pwa/chrome/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//www.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.googleapis.com" crossorigin> <link rel="preconnect" href="//apis.google.com" crossorigin> <link rel="preconnect" href="//www.google-analytics.com" crossorigin><link rel="stylesheet" href="//fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"> <link rel="stylesheet" href="//fonts.googleapis.com/css2?family=Material+Icons&family=Material+Symbols+Outlined&display=block"><link rel="stylesheet" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/chrome/css/app.css"> <link rel="stylesheet" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/chrome/css/dark-theme.css" disabled> <link rel="shortcut icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/chrome/images/favicon.png"> <link rel="apple-touch-icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/chrome/images/touchicon-180.png"><link rel="canonical" href="https://developer.chrome.com/docs/extensions/reference/api/downloads"><link rel="search" type="application/opensearchdescription+xml" title="Chrome for Developers" href="https://developer.chrome.com/s/opensearch.xml"> <link rel="alternate" hreflang="en" href="https://developer.chrome.com/docs/extensions/reference/api/downloads" /><link rel="alternate" hreflang="x-default" href="https://developer.chrome.com/docs/extensions/reference/api/downloads" /><link rel="alternate" hreflang="ar" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=ar" /><link rel="alternate" hreflang="bn" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=bn" /><link rel="alternate" hreflang="zh-Hans" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=zh-cn" /><link rel="alternate" hreflang="zh-Hant" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=zh-tw" /><link rel="alternate" hreflang="nl" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=nl" /><link rel="alternate" hreflang="fa" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=fa" /><link rel="alternate" hreflang="fr" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=fr" /><link rel="alternate" hreflang="de" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=de" /><link rel="alternate" hreflang="he" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=he" /><link rel="alternate" hreflang="hi" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=hi" /><link rel="alternate" hreflang="id" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=id" /><link rel="alternate" hreflang="it" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=it" /><link rel="alternate" hreflang="ja" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=ja" /><link rel="alternate" hreflang="ko" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=ko" /><link rel="alternate" hreflang="pl" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=pl" /><link rel="alternate" hreflang="pt-BR" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=pt-br" /><link rel="alternate" hreflang="ru" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=ru" /><link rel="alternate" hreflang="es-419" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=es-419" /><link rel="alternate" hreflang="th" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=th" /><link rel="alternate" hreflang="tr" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=tr" /><link rel="alternate" hreflang="vi" href="https://developer.chrome.com/docs/extensions/reference/api/downloads?hl=vi" /><link rel="alternate" hreflang="en-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads" /><link rel="alternate" hreflang="x-default" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads" /><link rel="alternate" hreflang="ar-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=ar" /><link rel="alternate" hreflang="bn-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=bn" /><link rel="alternate" hreflang="zh-Hans-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=zh-cn" /><link rel="alternate" hreflang="zh-Hant-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=zh-tw" /><link rel="alternate" hreflang="nl-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=nl" /><link rel="alternate" hreflang="fa-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=fa" /><link rel="alternate" hreflang="fr-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=fr" /><link rel="alternate" hreflang="de-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=de" /><link rel="alternate" hreflang="he-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=he" /><link rel="alternate" hreflang="hi-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=hi" /><link rel="alternate" hreflang="id-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=id" /><link rel="alternate" hreflang="it-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=it" /><link rel="alternate" hreflang="ja-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=ja" /><link rel="alternate" hreflang="ko-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=ko" /><link rel="alternate" hreflang="pl-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=pl" /><link rel="alternate" hreflang="pt-BR-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=pt-br" /><link rel="alternate" hreflang="ru-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=ru" /><link rel="alternate" hreflang="es-419-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=es-419" /><link rel="alternate" hreflang="th-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=th" /><link rel="alternate" hreflang="tr-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=tr" /><link rel="alternate" hreflang="vi-cn" href="https://developer.chrome.google.cn/docs/extensions/reference/api/downloads?hl=vi" /><title>chrome.downloads  |  API  |  Chrome for Developers</title> <meta property="og:title" content="chrome.downloads  |  API  |  Chrome for Developers"><meta property="og:url" content="https://developer.chrome.com/docs/extensions/reference/api/downloads"><meta property="og:locale" content="en"><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Article", "headline": "chrome.downloads" } </script><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "Docs", "item": "https://developer.chrome.com/docs" },{ "@type": "ListItem", "position": 2, "name": "Chrome Extensions", "item": "https://developer.chrome.com/docs/extensions" },{ "@type": "ListItem", "position": 3, "name": "Reference", "item": "https://developer.chrome.com/docs/extensions/reference" },{ "@type": "ListItem", "position": 4, "name": "API", "item": "https://developer.chrome.com/docs/extensions/reference/api" },{ "@type": "ListItem", "position": 5, "name": "chrome.downloads", "item": "https://developer.chrome.com/docs/extensions/reference/api/downloads" }] } </script> <link rel="stylesheet" href="/extras.css"></head> <body class="" template="page" theme="chrome-theme" type="article" appearance layout="docs" display-toc pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <section class="devsite-wrapper"> <devsite-cookie-notification-bar></devsite-cookie-notification-bar><devsite-header role="banner"> <div class="devsite-header--inner nocontent"> <div class="devsite-top-logo-row-wrapper-wrapper"> <div class="devsite-top-logo-row-wrapper"> <div class="devsite-top-logo-row"> <button type="button" id="devsite-hamburger-menu" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Navigation menu button" visually-hidden aria-label="Open menu"> </button> <div class="devsite-product-name-wrapper"> <a href="/" class="devsite-site-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Site logo" track-type="globalNav" track-name="chromeForDevelopers" track-metadata-position="nav" track-metadata-eventDetail="nav"> <picture> <source srcset="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/chrome/images/lockup-dark-theme.svg" media="(prefers-color-scheme: dark)" class="devsite-dark-theme" alt="Chrome for Developers"> <img src="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/chrome/images/lockup.svg" class="devsite-site-logo" alt="Chrome for Developers"> </picture> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" > <li class="devsite-breadcrumb-item "> </li> </ul> </span> </div> <div class="devsite-top-logo-row-middle"> <div class="devsite-header-upper-tabs"> <devsite-tabs class="upper-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Upper tabs"> <tab > <a href="https://developer.chrome.com/case-studies" track-metadata-eventdetail="https://developer.chrome.com/case-studies" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - get inspired" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Get inspired" track-name="get inspired" > Get inspired </a> </tab> <tab > <a href="https://developer.chrome.com/blog" track-metadata-eventdetail="https://developer.chrome.com/blog" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - blog" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Blog" track-name="blog" > Blog </a> </tab> <tab class="devsite-dropdown devsite-dropdown-full devsite-active "> <a href="https://developer.chrome.com/docs" track-metadata-eventdetail="https://developer.chrome.com/docs" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - docs" track-metadata-module="primary nav" aria-label="Docs, selected" data-category="Site-Wide Custom Events" data-label="Tab: Docs" track-name="docs" > Docs </a> <a href="#" role="button" aria-haspopup="true" aria-expanded="false" aria-label="Dropdown menu for Docs" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs" track-metadata-position="nav - docs" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Docs" track-name="docs" class="devsite-tabs-dropdown-toggle devsite-icon devsite-icon-arrow-drop-down"></a> <div class="devsite-tabs-dropdown" aria-label="submenu" hidden> <div class="devsite-tabs-dropdown-content"> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section build-icon dcc-subnav"> <li class="devsite-nav-title" role="heading" tooltip>Build with Chrome</li> <li class="devsite-nav-description">Learn how Chrome works, participate in origin trials, and build with Chrome everywhere. </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/web-platform" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/web-platform" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="build with chrome" tooltip > <div class="devsite-nav-item-title"> Web Platform </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/capabilities" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/capabilities" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="build with chrome" tooltip > <div class="devsite-nav-item-title"> Capabilities </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/chromedriver" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/chromedriver" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="build with chrome" tooltip > <div class="devsite-nav-item-title"> ChromeDriver </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/extensions" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/extensions" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="build with chrome" tooltip > <div class="devsite-nav-item-title"> Extensions </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/webstore" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/webstore" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="build with chrome" tooltip > <div class="devsite-nav-item-title"> Chrome Web Store </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/chromium" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/chromium" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="build with chrome" tooltip > <div class="devsite-nav-item-title"> Chromium </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/aurora" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/aurora" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="build with chrome" tooltip > <div class="devsite-nav-item-title"> Aurora </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/android" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/android" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="build with chrome" tooltip > <div class="devsite-nav-item-title"> Web on Android </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/origintrials/" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/origintrials/" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="build with chrome" tooltip > <div class="devsite-nav-item-title"> Origin trials </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/release-notes" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/release-notes" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="build with chrome" tooltip > <div class="devsite-nav-item-title"> Release notes </div> </a> </li> </ul> </div> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section productivity-icon dcc-subnav"> <li class="devsite-nav-title" role="heading" tooltip>Productivity</li> <li class="devsite-nav-description">Create the best experience for your users with the web's best tools.</li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/devtools" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/devtools" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="productivity" tooltip > <div class="devsite-nav-item-title"> DevTools </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/lighthouse" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/lighthouse" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="productivity" tooltip > <div class="devsite-nav-item-title"> Lighthouse </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/crux" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/crux" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="productivity" tooltip > <div class="devsite-nav-item-title"> Chrome UX Report </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/accessibility" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/accessibility" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="productivity" tooltip > <div class="devsite-nav-item-title"> Accessibility </div> </a> </li> </ul> <ul class="devsite-tabs-dropdown-section dcc-subnav second-column-list"> <li class="devsite-nav-description">Get things done quicker and neater, with our ready-made libraries. </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/workbox" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/workbox" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="productivity" tooltip > <div class="devsite-nav-item-title"> Workbox </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/puppeteer" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/puppeteer" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="productivity" tooltip > <div class="devsite-nav-item-title"> Puppeteer </div> </a> </li> </ul> </div> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section experience-icon dcc-subnav"> <li class="devsite-nav-title" role="heading" tooltip>Experience</li> <li class="devsite-nav-description">Design a beautiful and performant web with Chrome. </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/ai" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/ai" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="experience" tooltip > <div class="devsite-nav-item-title"> AI </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/performance" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/performance" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="experience" tooltip > <div class="devsite-nav-item-title"> Performance </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/css-ui" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/css-ui" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="experience" tooltip > <div class="devsite-nav-item-title"> CSS and UI </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/identity" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/identity" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="experience" tooltip > <div class="devsite-nav-item-title"> Identity </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/payments" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/payments" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="experience" tooltip > <div class="devsite-nav-item-title"> Payments </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/privacy-security" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/privacy-security" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="experience" tooltip > <div class="devsite-nav-item-title"> Privacy and security </div> </a> </li> </ul> </div> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section resources-icon dcc-subnav"> <li class="devsite-nav-title" role="heading" tooltip>Resources</li> <li class="devsite-nav-description">More from the Chrome team. </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="resources" tooltip > <div class="devsite-nav-item-title"> All documentation </div> </a> </li> <li class="devsite-nav-item"> <a href="https://web.dev/baseline" track-type="nav" track-metadata-eventdetail="https://web.dev/baseline" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="resources" tooltip > <div class="devsite-nav-item-title"> Baseline </div> </a> </li> <li class="devsite-nav-item"> <a href="https://web.dev" track-type="nav" track-metadata-eventdetail="https://web.dev" track-metadata-position="nav - docs" track-metadata-module="tertiary nav" track-metadata-module_headline="resources" tooltip > <div class="devsite-nav-item-title"> web.dev </div> </a> </li> </ul> </div> </div> </div> </tab> <tab > <a href="https://developer.chrome.com/new" track-metadata-eventdetail="https://developer.chrome.com/new" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - new in chrome" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: New in Chrome" track-name="new in chrome" > New in Chrome </a> </tab> </nav> </devsite-tabs> </div> <devsite-search enable-signin enable-search enable-suggestions enable-query-completion project-name="API" tenant-name="Chrome for Developers" > <form class="devsite-search-form" action="https://developer.chrome.com/s/results" method="GET"> <div class="devsite-search-container"> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-expanded="false" aria-haspopup="listbox" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="combobox" type="text" value="" > <div class="devsite-search-image material-icons" aria-hidden="true"> </div> <div class="devsite-search-shortcut-icon-container" aria-hidden="true"> <kbd class="devsite-search-shortcut-icon">/</kbd> </div> </div> </div> </form> <button type="button" search-close class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Close search"></button> </devsite-search> </div> <devsite-appearance-selector></devsite-appearance-selector> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="nl" >Nederlands</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> <devsite-user enable-profiles id="devsite-user"> <span class="button devsite-top-button" aria-hidden="true" visually-hidden>Sign in</span> </devsite-user> </div> </div> </div> <div class="devsite-collapsible-section "> <div class="devsite-header-background"> <div class="devsite-product-id-row" > <div class="devsite-product-description-row"> <ul class="devsite-breadcrumb-list" aria-label="Lower header breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developer.chrome.com/docs/extensions" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Lower Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="Chrome Extensions" > Chrome Extensions </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developer.chrome.com/docs/extensions/reference" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Lower Header" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="Reference" > Reference </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developer.chrome.com/docs/extensions/reference/api" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Lower Header" data-value="3" track-type="globalNav" track-name="breadcrumb" track-metadata-position="3" track-metadata-eventdetail="API" > API </a> </li> </ul> </div> </div> <div class="devsite-doc-set-nav-row"> <devsite-tabs class="lower-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Lower tabs"> <tab > <a href="https://developer.chrome.com/docs/extensions" track-metadata-eventdetail="https://developer.chrome.com/docs/extensions" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - overview" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Overview" track-name="overview" > Overview </a> </tab> <tab > <a href="https://developer.chrome.com/docs/extensions/get-started" track-metadata-eventdetail="https://developer.chrome.com/docs/extensions/get-started" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - get started" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Get Started" track-name="get started" > Get Started </a> </tab> <tab > <a href="https://developer.chrome.com/docs/extensions/develop" track-metadata-eventdetail="https://developer.chrome.com/docs/extensions/develop" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - develop" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Develop" track-name="develop" > Develop </a> </tab> <tab > <a href="https://developer.chrome.com/docs/extensions/how-to" track-metadata-eventdetail="https://developer.chrome.com/docs/extensions/how-to" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - how to" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: How To" track-name="how to" > How To </a> </tab> <tab > <a href="https://developer.chrome.com/docs/extensions/ai" track-metadata-eventdetail="https://developer.chrome.com/docs/extensions/ai" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - ai" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: AI" track-name="ai" > AI </a> </tab> <tab class="devsite-dropdown devsite-active "> <a href="https://developer.chrome.com/docs/extensions/reference" track-metadata-eventdetail="https://developer.chrome.com/docs/extensions/reference" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - reference" track-metadata-module="primary nav" aria-label="Reference, selected" data-category="Site-Wide Custom Events" data-label="Tab: Reference" track-name="reference" > Reference </a> <a href="#" role="button" aria-haspopup="true" aria-expanded="false" aria-label="Dropdown menu for Reference" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/extensions/reference" track-metadata-position="nav - reference" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Reference" track-name="reference" class="devsite-tabs-dropdown-toggle devsite-icon devsite-icon-arrow-drop-down"></a> <div class="devsite-tabs-dropdown" aria-label="submenu" hidden> <div class="devsite-tabs-dropdown-content"> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/extensions/reference/api" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/extensions/reference/api" track-metadata-position="nav - reference" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> API </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/extensions/reference/permissions-list" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/extensions/reference/permissions-list" track-metadata-position="nav - reference" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Permissions </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/extensions/reference/manifest" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/extensions/reference/manifest" track-metadata-position="nav - reference" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Manifest </div> </a> </li> </ul> </div> </div> </div> </tab> <tab > <a href="https://developer.chrome.com/docs/extensions/samples" track-metadata-eventdetail="https://developer.chrome.com/docs/extensions/samples" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - samples" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Samples" track-name="samples" > Samples </a> </tab> <tab class="devsite-dropdown "> <a href="https://developer.chrome.com/docs/webstore" track-metadata-eventdetail="https://developer.chrome.com/docs/webstore" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - chrome web store" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Chrome Web Store" track-name="chrome web store" > Chrome Web Store </a> <a href="#" role="button" aria-haspopup="true" aria-expanded="false" aria-label="Dropdown menu for Chrome Web Store" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/webstore" track-metadata-position="nav - chrome web store" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Chrome Web Store" track-name="chrome web store" class="devsite-tabs-dropdown-toggle devsite-icon devsite-icon-arrow-drop-down"></a> <div class="devsite-tabs-dropdown" aria-label="submenu" hidden> <div class="devsite-tabs-dropdown-content"> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/webstore/prepare" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/webstore/prepare" track-metadata-position="nav - chrome web store" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Prepare your Extension </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/webstore/publish" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/webstore/publish" track-metadata-position="nav - chrome web store" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Publish in the Chrome Web Store </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/webstore/program-policies" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/webstore/program-policies" track-metadata-position="nav - chrome web store" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Program Policies </div> </a> </li> </ul> </div> </div> </div> </tab> </nav> </devsite-tabs> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars > <div class="devsite-book-nav-filter" > <span class="filter-list-icon material-icons" aria-hidden="true"></span> <input type="text" placeholder="Filter" aria-label="Type to filter" role="searchbox"> <span class="filter-clear-button hidden" data-title="Clear filter" aria-label="Clear filter" role="button" tabindex="0"></span> </div> <nav class="devsite-book-nav devsite-nav nocontent" aria-label="Side menu"> <div class="devsite-mobile-header"> <button type="button" id="devsite-close-nav" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close navigation" aria-label="Close navigation"> </button> <div class="devsite-product-name-wrapper"> <a href="/" class="devsite-site-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Site logo" track-type="globalNav" track-name="chromeForDevelopers" track-metadata-position="nav" track-metadata-eventDetail="nav"> <picture> <source srcset="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/chrome/images/lockup-dark-theme.svg" media="(prefers-color-scheme: dark)" class="devsite-dark-theme" alt="Chrome for Developers"> <img src="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/chrome/images/lockup.svg" class="devsite-site-logo" alt="Chrome for Developers"> </picture> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" > <li class="devsite-breadcrumb-item "> </li> </ul> </span> </div> </div> <div class="devsite-book-nav-wrapper"> <div class="devsite-mobile-nav-top"> <ul class="devsite-nav-list"> <li class="devsite-nav-item"> <a href="/case-studies" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Get inspired" track-name="get inspired" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Get inspired" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Get inspired </span> </a> </li> <li class="devsite-nav-item"> <a href="/blog" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Blog" track-name="blog" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Blog" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Blog </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs" class="devsite-nav-title gc-analytics-event devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Tab: Docs" track-name="docs" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Docs" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Docs </span> </a> <ul class="devsite-nav-responsive-tabs devsite-nav-has-menu "> <li class="devsite-nav-item"> <span class="devsite-nav-title" tooltip data-category="Site-Wide Custom Events" data-label="Tab: Docs" track-name="docs" > <span class="devsite-nav-text" tooltip menu="Docs"> More </span> <span class="devsite-nav-icon material-icons" data-icon="forward" menu="Docs"> </span> </span> </li> </ul> <ul class="devsite-nav-responsive-tabs"> <li class="devsite-nav-item"> <a href="/docs/extensions" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Overview" track-name="overview" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Overview" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Overview </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/extensions/get-started" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Get Started" track-name="get started" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Get Started" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Get Started </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/extensions/develop" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Develop" track-name="develop" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Develop" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Develop </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/extensions/how-to" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: How To" track-name="how to" data-category="Site-Wide Custom Events" data-label="Responsive Tab: How To" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > How To </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/extensions/ai" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: AI" track-name="ai" data-category="Site-Wide Custom Events" data-label="Responsive Tab: AI" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > AI </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/extensions/reference" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Tab: Reference" track-name="reference" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Reference" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip menu="_book"> Reference </span> <span class="devsite-nav-icon material-icons" data-icon="forward" menu="_book"> </span> </a> <ul class="devsite-nav-responsive-tabs devsite-nav-has-menu devsite-lower-tab-item"> <li class="devsite-nav-item"> <span class="devsite-nav-title" tooltip data-category="Site-Wide Custom Events" data-label="Tab: Reference" track-name="reference" > <span class="devsite-nav-text" tooltip menu="Reference"> More </span> <span class="devsite-nav-icon material-icons" data-icon="forward" menu="Reference"> </span> </span> </li> </ul> </li> <li class="devsite-nav-item"> <a href="/docs/extensions/samples" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Samples" track-name="samples" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Samples" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Samples </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/webstore" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Chrome Web Store" track-name="chrome web store" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Chrome Web Store" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Chrome Web Store </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> <ul class="devsite-nav-responsive-tabs devsite-nav-has-menu devsite-lower-tab-item"> <li class="devsite-nav-item"> <span class="devsite-nav-title" tooltip data-category="Site-Wide Custom Events" data-label="Tab: Chrome Web Store" track-name="chrome web store" > <span class="devsite-nav-text" tooltip menu="Chrome Web Store"> More </span> <span class="devsite-nav-icon material-icons" data-icon="forward" menu="Chrome Web Store"> </span> </span> </li> </ul> </li> </ul> </li> <li class="devsite-nav-item"> <a href="/new" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: New in Chrome" track-name="new in chrome" data-category="Site-Wide Custom Events" data-label="Responsive Tab: New in Chrome" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > New in Chrome </span> </a> </li> </ul> </div> <div class="devsite-mobile-nav-bottom"> <ul class="devsite-nav-list" menu="_book"> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Manifest V3</span> </div></li> <li class="devsite-nav-item devsite-nav-deprecated"><a href="/docs/extensions/mv2/reference" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/mv2/reference" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/mv2/reference" ><span class="devsite-nav-text" tooltip>➡ Manifest V2</span><span class="devsite-nav-icon material-icons" data-icon="deprecated" data-title="Deprecated" aria-hidden="true"></span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/accessibilityFeatures" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/accessibilityFeatures" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/accessibilityFeatures" ><span class="devsite-nav-text" tooltip>accessibilityFeatures</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/action" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/action" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/action" ><span class="devsite-nav-text" tooltip>action</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/alarms" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/alarms" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/alarms" ><span class="devsite-nav-text" tooltip>alarms</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/audio" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/audio" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/audio" ><span class="devsite-nav-text" tooltip>audio</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/bookmarks" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/bookmarks" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/bookmarks" ><span class="devsite-nav-text" tooltip>bookmarks</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/browsingData" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/browsingData" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/browsingData" ><span class="devsite-nav-text" tooltip>browsingData</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/certificateProvider" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/certificateProvider" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/certificateProvider" ><span class="devsite-nav-text" tooltip>certificateProvider</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/commands" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/commands" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/commands" ><span class="devsite-nav-text" tooltip>commands</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/contentSettings" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/contentSettings" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/contentSettings" ><span class="devsite-nav-text" tooltip>contentSettings</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/contextMenus" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/contextMenus" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/contextMenus" ><span class="devsite-nav-text" tooltip>contextMenus</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/cookies" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/cookies" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/cookies" ><span class="devsite-nav-text" tooltip>cookies</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/debugger" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/debugger" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/debugger" ><span class="devsite-nav-text" tooltip>debugger</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/declarativeContent" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/declarativeContent" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/declarativeContent" ><span class="devsite-nav-text" tooltip>declarativeContent</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/declarativeNetRequest" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/declarativeNetRequest" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/declarativeNetRequest" ><span class="devsite-nav-text" tooltip>declarativeNetRequest</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/desktopCapture" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/desktopCapture" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/desktopCapture" ><span class="devsite-nav-text" tooltip>desktopCapture</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/devtools/inspectedWindow" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/devtools/inspectedWindow" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/devtools/inspectedWindow" ><span class="devsite-nav-text" tooltip>devtools.inspectedWindow</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/devtools/network" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/devtools/network" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/devtools/network" ><span class="devsite-nav-text" tooltip>devtools.network</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/devtools/panels" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/devtools/panels" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/devtools/panels" ><span class="devsite-nav-text" tooltip>devtools.panels</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/devtools/performance" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/devtools/performance" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/devtools/performance" ><span class="devsite-nav-text" tooltip>devtools.performance</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/devtools/recorder" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/devtools/recorder" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/devtools/recorder" ><span class="devsite-nav-text" tooltip>devtools.recorder</span></a></li> <li class="devsite-nav-item devsite-nav-nightly"><a href="/docs/extensions/reference/api/dns" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/dns" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/dns" ><span class="devsite-nav-text" tooltip>dns</span><span class="devsite-nav-icon material-icons" data-icon="nightly" data-title="Nightly build only" aria-hidden="true"></span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/documentScan" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/documentScan" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/documentScan" ><span class="devsite-nav-text" tooltip>documentScan</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/dom" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/dom" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/dom" ><span class="devsite-nav-text" tooltip>dom</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/downloads" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/downloads" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/downloads" ><span class="devsite-nav-text" tooltip>downloads</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/enterprise/deviceAttributes" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/enterprise/deviceAttributes" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/enterprise/deviceAttributes" ><span class="devsite-nav-text" tooltip>enterprise.deviceAttributes</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/enterprise/hardwarePlatform" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/enterprise/hardwarePlatform" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/enterprise/hardwarePlatform" ><span class="devsite-nav-text" tooltip>enterprise.hardwarePlatform</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/enterprise/networkingAttributes" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/enterprise/networkingAttributes" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/enterprise/networkingAttributes" ><span class="devsite-nav-text" tooltip>enterprise.networkingAttributes</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/enterprise/platformKeys" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/enterprise/platformKeys" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/enterprise/platformKeys" ><span class="devsite-nav-text" tooltip>enterprise.platformKeys</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/events" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/events" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/events" ><span class="devsite-nav-text" tooltip>events</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/extension" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/extension" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/extension" ><span class="devsite-nav-text" tooltip>extension</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/extensionTypes" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/extensionTypes" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/extensionTypes" ><span class="devsite-nav-text" tooltip>extensionTypes</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/fileBrowserHandler" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/fileBrowserHandler" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/fileBrowserHandler" ><span class="devsite-nav-text" tooltip>fileBrowserHandler</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/fileSystemProvider" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/fileSystemProvider" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/fileSystemProvider" ><span class="devsite-nav-text" tooltip>fileSystemProvider</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/fontSettings" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/fontSettings" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/fontSettings" ><span class="devsite-nav-text" tooltip>fontSettings</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/gcm" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/gcm" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/gcm" ><span class="devsite-nav-text" tooltip>gcm</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/history" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/history" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/history" ><span class="devsite-nav-text" tooltip>history</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/i18n" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/i18n" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/i18n" ><span class="devsite-nav-text" tooltip>i18n</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/identity" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/identity" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/identity" ><span class="devsite-nav-text" tooltip>identity</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/idle" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/idle" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/idle" ><span class="devsite-nav-text" tooltip>idle</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/input/ime" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/input/ime" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/input/ime" ><span class="devsite-nav-text" tooltip>input.ime</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/instanceID" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/instanceID" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/instanceID" ><span class="devsite-nav-text" tooltip>instanceID</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/loginState" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/loginState" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/loginState" ><span class="devsite-nav-text" tooltip>loginState</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/management" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/management" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/management" ><span class="devsite-nav-text" tooltip>management</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/notifications" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/notifications" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/notifications" ><span class="devsite-nav-text" tooltip>notifications</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/offscreen" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/offscreen" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/offscreen" ><span class="devsite-nav-text" tooltip>offscreen</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/omnibox" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/omnibox" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/omnibox" ><span class="devsite-nav-text" tooltip>omnibox</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/pageCapture" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/pageCapture" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/pageCapture" ><span class="devsite-nav-text" tooltip>pageCapture</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/permissions" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/permissions" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/permissions" ><span class="devsite-nav-text" tooltip>permissions</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/platformKeys" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/platformKeys" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/platformKeys" ><span class="devsite-nav-text" tooltip>platformKeys</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/power" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/power" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/power" ><span class="devsite-nav-text" tooltip>power</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/printerProvider" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/printerProvider" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/printerProvider" ><span class="devsite-nav-text" tooltip>printerProvider</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/printing" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/printing" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/printing" ><span class="devsite-nav-text" tooltip>printing</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/printingMetrics" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/printingMetrics" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/printingMetrics" ><span class="devsite-nav-text" tooltip>printingMetrics</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/privacy" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/privacy" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/privacy" ><span class="devsite-nav-text" tooltip>privacy</span></a></li> <li class="devsite-nav-item devsite-nav-nightly"><a href="/docs/extensions/reference/api/processes" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/processes" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/processes" ><span class="devsite-nav-text" tooltip>processes</span><span class="devsite-nav-icon material-icons" data-icon="nightly" data-title="Nightly build only" aria-hidden="true"></span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/proxy" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/proxy" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/proxy" ><span class="devsite-nav-text" tooltip>proxy</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/readingList" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/readingList" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/readingList" ><span class="devsite-nav-text" tooltip>readingList</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/runtime" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/runtime" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/runtime" ><span class="devsite-nav-text" tooltip>runtime</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/scripting" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/scripting" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/scripting" ><span class="devsite-nav-text" tooltip>scripting</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/search" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/search" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/search" ><span class="devsite-nav-text" tooltip>search</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/sessions" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/sessions" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/sessions" ><span class="devsite-nav-text" tooltip>sessions</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/sidePanel" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/sidePanel" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/sidePanel" ><span class="devsite-nav-text" tooltip>sidePanel</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/storage" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/storage" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/storage" ><span class="devsite-nav-text" tooltip>storage</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/system/cpu" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/system/cpu" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/system/cpu" ><span class="devsite-nav-text" tooltip>system.cpu</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/system/display" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/system/display" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/system/display" ><span class="devsite-nav-text" tooltip>system.display</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/system/memory" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/system/memory" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/system/memory" ><span class="devsite-nav-text" tooltip>system.memory</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/system/storage" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/system/storage" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/system/storage" ><span class="devsite-nav-text" tooltip>system.storage</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/systemLog" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/systemLog" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/systemLog" ><span class="devsite-nav-text" tooltip>systemLog</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/tabCapture" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/tabCapture" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/tabCapture" ><span class="devsite-nav-text" tooltip>tabCapture</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/tabGroups" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/tabGroups" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/tabGroups" ><span class="devsite-nav-text" tooltip>tabGroups</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/tabs" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/tabs" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/tabs" ><span class="devsite-nav-text" tooltip>tabs</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/topSites" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/topSites" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/topSites" ><span class="devsite-nav-text" tooltip>topSites</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/tts" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/tts" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/tts" ><span class="devsite-nav-text" tooltip>tts</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/ttsEngine" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/ttsEngine" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/ttsEngine" ><span class="devsite-nav-text" tooltip>ttsEngine</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/types" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/types" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/types" ><span class="devsite-nav-text" tooltip>types</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/userScripts" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/userScripts" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/userScripts" ><span class="devsite-nav-text" tooltip>userScripts</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/vpnProvider" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/vpnProvider" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/vpnProvider" ><span class="devsite-nav-text" tooltip>vpnProvider</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/wallpaper" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/wallpaper" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/wallpaper" ><span class="devsite-nav-text" tooltip>wallpaper</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/webAuthenticationProxy" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/webAuthenticationProxy" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/webAuthenticationProxy" ><span class="devsite-nav-text" tooltip>webAuthenticationProxy</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/webNavigation" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/webNavigation" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/webNavigation" ><span class="devsite-nav-text" tooltip>webNavigation</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/webRequest" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/webRequest" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/webRequest" ><span class="devsite-nav-text" tooltip>webRequest</span></a></li> <li class="devsite-nav-item"><a href="/docs/extensions/reference/api/windows" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /docs/extensions/reference/api/windows" track-type="bookNav" track-name="click" track-metadata-eventdetail="/docs/extensions/reference/api/windows" ><span class="devsite-nav-text" tooltip>windows</span></a></li> </ul> <ul class="devsite-nav-list" menu="Docs" aria-label="Side menu" hidden> <li class="devsite-nav-item devsite-nav-heading"> <span class="devsite-nav-title" tooltip > <span class="devsite-nav-text" tooltip > Build with Chrome </span> </span> </li> <li class="devsite-nav-item"> <a href="/docs/web-platform" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Web Platform" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Web Platform </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/capabilities" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Capabilities" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Capabilities </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/chromedriver" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: ChromeDriver" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > ChromeDriver </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/extensions" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Extensions" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Extensions </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/webstore" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Chrome Web Store" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Chrome Web Store </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/chromium" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Chromium" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Chromium </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/aurora" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Aurora" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Aurora </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/android" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Web on Android" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Web on Android </span> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/origintrials/" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Origin trials" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Origin trials </span> </a> </li> <li class="devsite-nav-item"> <a href="/release-notes" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Release notes" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Release notes </span> </a> </li> <li class="devsite-nav-item devsite-nav-heading"> <span class="devsite-nav-title" tooltip > <span class="devsite-nav-text" tooltip > Productivity </span> </span> </li> <li class="devsite-nav-item"> <a href="/docs/devtools" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: DevTools" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > DevTools </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/lighthouse" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Lighthouse" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Lighthouse </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/crux" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Chrome UX Report" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Chrome UX Report </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/accessibility" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Accessibility" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Accessibility </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/workbox" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Workbox" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Workbox </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/puppeteer" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Puppeteer" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Puppeteer </span> </a> </li> <li class="devsite-nav-item devsite-nav-heading"> <span class="devsite-nav-title" tooltip > <span class="devsite-nav-text" tooltip > Experience </span> </span> </li> <li class="devsite-nav-item"> <a href="/docs/ai" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: AI" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > AI </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/performance" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Performance" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Performance </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/css-ui" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: CSS and UI" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > CSS and UI </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/identity" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Identity" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Identity </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/payments" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Payments" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Payments </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/privacy-security" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Privacy and security" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Privacy and security </span> </a> </li> <li class="devsite-nav-item devsite-nav-heading"> <span class="devsite-nav-title" tooltip > <span class="devsite-nav-text" tooltip > Resources </span> </span> </li> <li class="devsite-nav-item"> <a href="/docs" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: All documentation" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > All documentation </span> </a> </li> <li class="devsite-nav-item"> <a href="https://web.dev/baseline" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Baseline" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Baseline </span> </a> </li> <li class="devsite-nav-item"> <a href="https://web.dev" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: web.dev" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > web.dev </span> </a> </li> </ul> <ul class="devsite-nav-list" menu="Reference" aria-label="Side menu" hidden> <li class="devsite-nav-item"> <a href="/docs/extensions/reference/api" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: API" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > API </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/extensions/reference/permissions-list" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Permissions" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Permissions </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/extensions/reference/manifest" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Manifest" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Manifest </span> </a> </li> </ul> <ul class="devsite-nav-list" menu="Chrome Web Store" aria-label="Side menu" hidden> <li class="devsite-nav-item"> <a href="/docs/webstore/prepare" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Prepare your Extension" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Prepare your Extension </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/webstore/publish" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Publish in the Chrome Web Store" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Publish in the Chrome Web Store </span> </a> </li> <li class="devsite-nav-item"> <a href="/docs/webstore/program-policies" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Program Policies" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Program Policies </span> </a> </li> </ul> </div> </div> </nav> </devsite-book-nav> <section id="gc-wrapper"> <main role="main" class="devsite-main-content" has-book-nav has-sidebar > <div class="devsite-sidebar"> <div class="devsite-sidebar-content"> <devsite-toc class="devsite-nav" role="navigation" aria-label="On this page" depth="2" scrollbars ></devsite-toc> <devsite-recommendations-sidebar class="nocontent devsite-nav"> </devsite-recommendations-sidebar> </div> </div> <devsite-content> <article class="devsite-article"> <div class="devsite-article-meta nocontent" role="navigation"> <ul class="devsite-breadcrumb-list" aria-label="Breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developer.chrome.com/" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="" > Home </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developer.chrome.com/docs" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="Docs" > Docs </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developer.chrome.com/docs/extensions" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="3" track-type="globalNav" track-name="breadcrumb" track-metadata-position="3" track-metadata-eventdetail="Chrome Extensions" > Chrome Extensions </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developer.chrome.com/docs/extensions/reference" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="4" track-type="globalNav" track-name="breadcrumb" track-metadata-position="4" track-metadata-eventdetail="Reference" > Reference </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developer.chrome.com/docs/extensions/reference/api" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="5" track-type="globalNav" track-name="breadcrumb" track-metadata-position="5" track-metadata-eventdetail="API" > API </a> </li> </ul> <devsite-thumb-rating position="header"> </devsite-thumb-rating> </div> <h1 class="devsite-page-title" tabindex="-1"> chrome.downloads </h1> <devsite-feature-tooltip ack-key="AckCollectionsBookmarkTooltipDismiss" analytics-category="Site-Wide Custom Events" analytics-action-show="Callout Profile displayed" analytics-action-close="Callout Profile dismissed" analytics-label="Create Collection Callout" class="devsite-page-bookmark-tooltip nocontent" dismiss-button="true" id="devsite-collections-dropdown" dismiss-button-text="Dismiss" close-button-text="Got it"> <devsite-bookmark></devsite-bookmark> <span slot="popout-heading"> Stay organized with collections </span> <span slot="popout-contents"> Save and categorize content based on your preferences. </span> </devsite-feature-tooltip> <div class="devsite-page-title-meta"><devsite-view-release-notes></devsite-view-release-notes></div> <devsite-toc class="devsite-nav" depth="2" devsite-toc-embedded > </devsite-toc> <div class="devsite-article-body clearfix "> <style>.dcc-reference{--color-hairline: #dadce0;--color-blue-lightest: rgba(232, 240, 254, 0.4);--color-blue-lighter: #d2e3fc;--color-blue-medium: #1967d2;--color-blue-darkest: #174ea6;--rgb-blue-darkest: 23, 78, 166;--color-yellow-lightest: rgba(254, 247, 224, 0.3);--color-yellow-lighter: #feefc3;--color-yellow-medium: #f29900;--color-yellow-darkest: #de7100;--rgb-yellow-darkest: 227, 117, 0;--color-red-lightest: rgba(252, 232, 230, 0.4);--color-red-lighter: rgba(252, 232, 230, 0.5);--color-red-medium: #c5221f;--color-red-darkest: #9f0e0e;--rgb-red-darkest: 165, 14, 14;--color-green-lightest: rgba(230, 244, 234, 0.4);--color-green-lighter: #ceead6;--color-green-medium: #188038;--color-green-darkest: #0d652d;--rgb-green-darkest: 13, 101, 45;--color-purple-lightest: rgba(243, 232, 253, 0.4);--color-purple-lighter: rgba(243, 232, 253, 0.5);--color-purple-medium: #8430ce;--color-purple-darkest: #681da8;--rgb-purple-darkest: 104, 29, 168;--color-pink-lightest: rgba(253, 231, 243, 0.4);--color-pink-lighter: rgba(253, 231, 243, 0.5);--color-pink-medium: #d01884;--color-pink-darkest: #9c166b;--rgb-pink-darkest: 156, 22, 107}.dcc-type--label{font-weight:500;font-size:.75rem;line-height:1.3333333333}.dcc-type--xsmall{font-size:.75rem;line-height:1.6666666667}h2.dcc-api-title{display:none}.dcc-code-sections ul{padding-left:0}.dcc-code-sections .dcc-code-sections{border:1px solid var(--color-hairline);padding:calc(1rem - 1px)}.dcc-code-sections .dcc-code-sections ul>li:first-child{border-top:0;padding-top:0}.dcc-code-sections .dcc-code-sections devsite-code{margin-left:calc(-1rem + 1px);margin-right:calc(-1rem + 1px)}.dcc-code-sections .dcc-type--small{font-size:.875em;line-height:2em}.dcc-code-sections__label{font-size:.875rem;line-height:2}.dcc-code-sections__type>:not(:last-child){margin-right:.5ch}.dcc-code-sections__enum{margin-bottom:1rem}.dcc-code-sections__icon::before{background:url("data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHJlY3Qgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2IiBmaWxsPSJ3aGl0ZSIvPgo8cGF0aCBmaWxsLXJ1bGU9ImV2ZW5vZGQiIGNsaXAtcnVsZT0iZXZlbm9kZCIgZD0iTTcuNzc2MzkgMS41NTI3OUM3LjkxNzE2IDEuNDgyNCA4LjA4Mjg0IDEuNDgyNCA4LjIyMzYxIDEuNTUyNzlMMTQuMjIzNiA0LjU1Mjc5QzE0LjM5MyA0LjYzNzQ4IDE0LjUgNC44MTA2MSAxNC41IDVWMTFDMTQuNSAxMS4xODk0IDE0LjM5MyAxMS4zNjI1IDE0LjIyMzYgMTEuNDQ3Mkw4LjIyMzYxIDE0LjQ0NzJDOC4wODI4NCAxNC41MTc2IDcuOTE3MTYgMTQuNTE3NiA3Ljc3NjM5IDE0LjQ0NzJMMS43NzYzOSAxMS40NDcyQzEuNjA3IDExLjM2MjUgMS41IDExLjE4OTQgMS41IDExVjVDMS41IDQuODEwNjEgMS42MDcgNC42Mzc0OCAxLjc3NjM5IDQuNTUyNzlMNy43NzYzOSAxLjU1Mjc5Wk0yLjUgNS44MDkwMlYxMC42OTFMNy41IDEzLjE5MVY4LjMwOTAyTDIuNSA1LjgwOTAyWk04LjUgOC4zMDkwMlYxMy4xOTFMMTMuNSAxMC42OTFWNS44MDkwMkw4LjUgOC4zMDkwMlpNMTIuODgyIDVMOCA3LjQ0MDk4TDMuMTE4MDMgNUw4IDIuNTU5MDJMMTIuODgyIDVaIiBmaWxsPSIjNUY2MzY4Ii8+Cjwvc3ZnPgo=") center/contain no-repeat;content:"";display:inline-block;height:1.25em;margin-right:.5ch;vertical-align:middle;width:1.25em}.dcc-code-sections__icon.dcc-code-sections__icon--number::before{background-image:url("data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHJlY3Qgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2IiBmaWxsPSJ3aGl0ZSIvPgo8cGF0aCBkPSJNNiAyLjVINFY0LjVINlYyLjVaIiBmaWxsPSIjNUY2MzY4Ii8+CjxwYXRoIGQ9Ik02IDUuNUg0VjcuNUg2VjUuNVoiIGZpbGw9IiM1RjYzNjgiLz4KPHBhdGggZD0iTTQgOC41SDZWMTAuNUg0VjguNVoiIGZpbGw9IiM1RjYzNjgiLz4KPHBhdGggZD0iTTkgMi41SDdWNC41SDlWMi41WiIgZmlsbD0iIzVGNjM2OCIvPgo8cGF0aCBkPSJNNyA1LjVIOVY3LjVIN1Y1LjVaIiBmaWxsPSIjNUY2MzY4Ii8+CjxwYXRoIGQ9Ik05IDguNUg3VjEwLjVIOVY4LjVaIiBmaWxsPSIjNUY2MzY4Ii8+CjxwYXRoIGQ9Ik03IDExLjVIOVYxMy41SDdWMTEuNVoiIGZpbGw9IiM1RjYzNjgiLz4KPHBhdGggZD0iTTEyIDIuNUgxMFY0LjVIMTJWMi41WiIgZmlsbD0iIzVGNjM2OCIvPgo8cGF0aCBkPSJNMTAgNS41SDEyVjcuNUgxMFY1LjVaIiBmaWxsPSIjNUY2MzY4Ii8+CjxwYXRoIGQ9Ik0xMiA4LjVIMTBWMTAuNUgxMlY4LjVaIiBmaWxsPSIjNUY2MzY4Ii8+Cjwvc3ZnPgo=")}.dcc-code-sections__icon.dcc-code-sections__icon--string::before{background-image:url("data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHJlY3Qgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2IiBmaWxsPSJ3aGl0ZSIvPgo8cGF0aCBkPSJNNC43MTQyOSAxMkg1Ljg1NzE0TDcuMjg1NzEgOC4yODU3MVY0LjVDNy4yODU3MSA0LjIyMzg2IDcuMDYxODYgNCA2Ljc4NTcxIDRIMy41QzMuMjIzODYgNCAzIDQuMjIzODYgMyA0LjVWNy43ODU3MUMzIDguMDYxODYgMy4yMjM4NiA4LjI4NTcxIDMuNSA4LjI4NTcxSDYuMTQyODZMNC43MTQyOSAxMlpNMTAuNDI4NiAxMkgxMS41NzE0TDEzIDguMjg1NzFWNC41QzEzIDQuMjIzODYgMTIuNzc2MSA0IDEyLjUgNEg5LjIxNDI5QzguOTM4MTQgNCA4LjcxNDI5IDQuMjIzODYgOC43MTQyOSA0LjVWNy43ODU3MUM4LjcxNDI5IDguMDYxODYgOC45MzgxNCA4LjI4NTcxIDkuMjE0MjkgOC4yODU3MUgxMS44NTcxTDEwLjQyODYgMTJaIiBmaWxsPSIjNUY2MzY4Ii8+Cjwvc3ZnPgo=")}.dcc-code-sections__icon.dcc-code-sections__icon--boolean::before{background-image:url("data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHJlY3Qgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2IiBmaWxsPSJ3aGl0ZSIvPgo8cGF0aCBkPSJNMTIuMzUzNiA1Ljg1MzU1TDExLjY0NjQgNS4xNDY0NUw3IDkuNzkyODlMNC44NTM1NSA3LjY0NjQ1TDQuMTQ2NDUgOC4zNTM1NUw3IDExLjIwNzFMMTIuMzUzNiA1Ljg1MzU1WiIgZmlsbD0iIzVGNjM2OCIvPgo8cGF0aCBmaWxsLXJ1bGU9ImV2ZW5vZGQiIGNsaXAtcnVsZT0iZXZlbm9kZCIgZD0iTTIgM0MyIDIuNDQ3NzIgMi40NDc3MiAyIDMgMkgxM0MxMy41NTIzIDIgMTQgMi40NDc3MiAxNCAzVjEzQzE0IDEzLjU1MjMgMTMuNTUyMyAxNCAxMyAxNEgzQzIuNDQ3NzIgMTQgMiAxMy41NTIzIDIgMTNWM1pNMyAzSDEzVjEzSDNMMyAzWiIgZmlsbD0iIzVGNjM2OCIvPgo8L3N2Zz4K")}.dcc-code-sections__icon.dcc-code-sections__icon--function::before{background-image:url("data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHJlY3Qgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2IiBmaWxsPSJ3aGl0ZSIvPgo8cGF0aCBmaWxsLXJ1bGU9ImV2ZW5vZGQiIGNsaXAtcnVsZT0iZXZlbm9kZCIgZD0iTTMuNSA0QzMuNSAyLjYxOTI5IDQuNjE5MjkgMS41IDYgMS41SDYuNVYyLjVINkM1LjE3MTU3IDIuNSA0LjUgMy4xNzE1NyA0LjUgNFY1Ljc2MzkzQzQuNSA2LjcxMDg2IDMuOTY0OTkgNy41NzY1MiAzLjExODAzIDhDMy45NjQ5OSA4LjQyMzQ4IDQuNSA5LjI4OTE0IDQuNSAxMC4yMzYxVjEyQzQuNSAxMi44Mjg0IDUuMTcxNTcgMTMuNSA2IDEzLjVINi41VjE0LjVINkM0LjYxOTI5IDE0LjUgMy41IDEzLjM4MDcgMy41IDEyVjEwLjIzNjFDMy41IDkuNjY3OTEgMy4xNzkgOS4xNDg1MiAyLjY3MDgyIDguODk0NDNMMS43NzYzOSA4LjQ0NzIxQzEuNjA3IDguMzYyNTIgMS41IDguMTg5MzkgMS41IDhDMS41IDcuODEwNjEgMS42MDcgNy42Mzc0OCAxLjc3NjM5IDcuNTUyNzlMMi42NzA4MiA3LjEwNTU3QzMuMTc5IDYuODUxNDggMy41IDYuMzMyMDkgMy41IDUuNzYzOTNWNFpNMTAgMi41SDkuNVYxLjVIMTBDMTEuMzgwNyAxLjUgMTIuNSAyLjYxOTI5IDEyLjUgNFY1Ljc2MzkzQzEyLjUgNi4zMzIwOSAxMi44MjEgNi44NTE0OCAxMy4zMjkyIDcuMTA1NTdMMTQuMjIzNiA3LjU1Mjc5QzE0LjM5MyA3LjYzNzQ4IDE0LjUgNy44MTA2MSAxNC41IDhDMTQuNSA4LjE4OTM5IDE0LjM5MyA4LjM2MjUyIDE0LjIyMzYgOC40NDcyMUwxMy4zMjkyIDguODk0NDNDMTIuODIxIDkuMTQ4NTIgMTIuNSA5LjY2NzkxIDEyLjUgMTAuMjM2MVYxMkMxMi41IDEzLjM4MDcgMTEuMzgwNyAxNC41IDEwIDE0LjVIOS41VjEzLjVIMTBDMTAuODI4NCAxMy41IDExLjUgMTIuODI4NCAxMS41IDEyVjEwLjIzNjFDMTEuNSA5LjI4OTE0IDEyLjAzNSA4LjQyMzQ4IDEyLjg4MiA4QzEyLjAzNSA3LjU3NjUyIDExLjUgNi43MTA4NiAxMS41IDUuNzYzOTNWNEMxMS41IDMuMTcxNTcgMTAuODI4NCAyLjUgMTAgMi41WiIgZmlsbD0iIzVGNjM2OCIvPgo8L3N2Zz4K")}.dcc-code-sections__icon.dcc-code-sections__icon--array::before{background-image:url("data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHJlY3Qgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2IiBmaWxsPSJ3aGl0ZSIvPgo8cGF0aCBmaWxsLXJ1bGU9ImV2ZW5vZGQiIGNsaXAtcnVsZT0iZXZlbm9kZCIgZD0iTTEyIDYuNUg0VjkuNUgxMlY2LjVaTTEyIDUuNUg0VjNIMTJWNS41Wk0xMyAzQzEzIDIuNDQ3NzIgMTIuNTUyMyAyIDEyIDJINEMzLjQ0NzcyIDIgMyAyLjQ0NzcyIDMgM1YxM0MzIDEzLjU1MjMgMy40NDc3MiAxNCA0IDE0SDEyQzEyLjU1MjMgMTQgMTMgMTMuNTUyMyAxMyAxM1YzWk0xMiAxMC41SDRWMTNIMTJWMTAuNVoiIGZpbGw9IiM1RjYzNjgiLz4KPC9zdmc+Cg==")}.dcc-code-sections__icon.dcc-code-sections__icon--reference::before{background-image:url("data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHJlY3Qgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2IiBmaWxsPSJ3aGl0ZSIvPgo8cGF0aCBkPSJNMyAySDhWM0gzTDMgMTNIMTNWOEgxNFYxM0MxNCAxMy41NTIzIDEzLjU1MjMgMTQgMTMgMTRIM0MyLjQ0NzcyIDE0IDIgMTMuNTUyMyAyIDEzVjNDMiAyLjQ0NzcyIDIuNDQ3NzIgMiAzIDJaIiBmaWxsPSIjNUY2MzY4Ii8+CjxwYXRoIGQ9Ik05LjUgM0gxMi4yOTI5TDUuNjQ2NDUgOS42NDY0NUw2LjM1MzU1IDEwLjM1MzZMMTMgMy43MDcxMVY2LjVIMTRWMkg5LjVWM1oiIGZpbGw9IiM1RjYzNjgiLz4KPC9zdmc+Cg==")}.dcc-code-sections__optional{color:var(--color-pink-medium)}.dcc-code-sections__value{color:var(--color-code-number)}.dcc-code-sections__deprecated{color:var(--color-red-medium)}.dcc-code-sections__callback{display:block}p>.dcc-code-sections__callback{margin-top:.5em}.dcc-code-sections__overline{border-top:1px solid var(--color-hairline);margin:1em 0;padding-top:get-size(300)}.dcc-code-sections__mode{color:var(--color-code-comment);text-transform:uppercase}.dcc-code-sections li{border-top:1px solid var(--color-hairline);display:flex;flex-direction:column;padding-top:get-size(300);position:relative}.dcc-code-sections li>:first-child{font-weight:500;flex:0 0 auto;flex-shrink:1;min-width:9rem;padding-right:1rem}.dcc-code-sections li>:not(:first-child){flex-grow:1}.dcc-code-sections--summary{padding-left:0}.dcc-code-sections--summary>li:first-child{border-top:0;padding-top:0}@media(min-width: 992px){.dcc-code-sections--summary>li{flex-direction:row}}.dcc-code-sections--summary>li>:first-child{min-width:6.5rem}.dcc-tag-pill{--flow-space: 0.25rem;box-sizing:border-box;border-radius:.75rem;font-weight:500;font-size:.75rem;line-height:1.3333333333;margin:calc(var(--flow-space)/2);background-color:var(--color-blue-lightest);color:var(--color-blue-darkest);margin-bottom:.5rem;padding:.25rem .75rem;cursor:help}.dcc-tag-pill--blue{background-color:var(--color-blue-lightest);color:var(--color-blue-darkest)}.dcc-tag-pill--yellow{background-color:var(--color-yellow-lightest);color:var(--color-yellow-darkest)}.dcc-tag-pill--red{background-color:var(--color-red-lightest);color:var(--color-red-darkest)}.dcc-tag-pill--green{background-color:var(--color-green-lightest);color:var(--color-green-darkest)}.dcc-tag-pill--pink{background-color:var(--color-pink-lightest);color:var(--color-pink-darkest)}.dcc-tag-pill--purple{background-color:var(--color-purple-lightest);color:var(--color-purple-darkest)}a>.dcc-tag-pill{cursor:pointer}</style> <p></p> <p><h2 class="dcc-api-title" data-text="Description" id="description" tabindex="-1">Description</h2> <div class="dcc-reference"><p>Use the <code translate="no" dir="ltr">chrome.downloads</code> API to programmatically initiate, monitor, manipulate, and search for downloads.</p></div></p> <p><h2 id="permissions" data-text="Permissions" tabindex="-1">Permissions</h2> <div class="dcc-reference"><code translate="no" dir="ltr">downloads</code><br /></div></p> <p>You must declare the <code translate="no" dir="ltr">"downloads"</code> permission in the <a href="/docs/extensions/reference/manifest">extension manifest</a> to use this API.</p> <pre class="prettyprint lang-json" translate="no" dir="ltr"><code translate="no" dir="ltr">{ "name": "My extension", ... "permissions": [ "downloads" ], } </code></pre> <p></p> <p></p> <h2 id="examples" data-text="Examples" tabindex="-1">Examples</h2> <p>You can find simple examples of using the <code translate="no" dir="ltr">chrome.downloads</code> API in the <a href="https://github.com/GoogleChrome/chrome-extensions-samples/tree/master/_archive/mv2/api/downloads/">examples/api/downloads</a> directory. For other examples and for help in viewing the source code, see <a href="/docs/extensions/mv2/samples">Samples</a>.</p> <p><div class="dcc-reference"><h2 id="type" data-text="Types" tabindex="-1">Types</h2> <div><div> <div class="notranslate"> <h3 id="type-BooleanDelta" data-text="BooleanDelta" tabindex="-1">BooleanDelta</h3> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="properties" data-text="Properties" tabindex="-1">Properties</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-BooleanDelta-current">current</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--boolean">boolean <span class="dcc-code-sections__optional">optional</span></p></div> </div></li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-BooleanDelta-previous">previous</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--boolean">boolean <span class="dcc-code-sections__optional">optional</span></p></div> </div></li></ul> </div><div> <div class="notranslate"> <h3 id="type-DangerType" data-text="DangerType" tabindex="-1">DangerType</h3> </div><p>file</p> <p>The download's filename is suspicious.</p> <p>url</p> <p>The download's URL is known to be malicious.</p> <p>content</p> <p>The downloaded file is known to be malicious.</p> <p>uncommon</p> <p>The download's URL is not commonly downloaded and could be dangerous.</p> <p>host</p> <p>The download came from a host known to distribute malicious binaries and is likely dangerous.</p> <p>unwanted</p> <p>The download is potentially unwanted or unsafe. E.g. it could make changes to browser or computer settings.</p> <p>safe</p> <p>The download presents no known danger to the user's computer.</p> <p>accepted</p> <p>The user has accepted the dangerous download.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="enum" data-text="Enum" tabindex="-1">Enum</h4><div class="dcc-code-sections__overline dcc-code-sections__label"> <p><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"file"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"url"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"content"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"uncommon"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"host"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"unwanted"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"safe"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"accepted"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"allowlistedByPolicy"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"asyncScanning"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"asyncLocalPasswordScanning"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"passwordProtected"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"blockedTooLarge"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"sensitiveContentWarning"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"sensitiveContentBlock"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"deepScannedFailed"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"deepScannedSafe"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"deepScannedOpenedDangerous"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"promptForScanning"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"promptForLocalPasswordScanning"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"accountCompromise"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"blockedScanFailed"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span></p> </div> </div><div> <div class="notranslate"> <h3 id="type-DoubleDelta" data-text="DoubleDelta" tabindex="-1">DoubleDelta</h3> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="properties_1" data-text="Properties" tabindex="-1">Properties</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DoubleDelta-current">current</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number <span class="dcc-code-sections__optional">optional</span></p></div> </div></li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DoubleDelta-previous">previous</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number <span class="dcc-code-sections__optional">optional</span></p></div> </div></li></ul> </div><div> <div class="notranslate"> <h3 id="type-DownloadDelta" data-text="DownloadDelta" tabindex="-1">DownloadDelta</h3> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="properties_2" data-text="Properties" tabindex="-1">Properties</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-canResume">canResume</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-BooleanDelta">BooleanDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">canResume</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-danger">danger</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-StringDelta">StringDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">danger</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-endTime">endTime</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-StringDelta">StringDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">endTime</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-error">error</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-StringDelta">StringDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">error</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-exists">exists</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-BooleanDelta">BooleanDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">exists</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-fileSize">fileSize</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-DoubleDelta">DoubleDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">fileSize</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-filename">filename</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-StringDelta">StringDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">filename</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-finalUrl">finalUrl</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-StringDelta">StringDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 54+ </span></div> </div><p>The change in <code translate="no" dir="ltr">finalUrl</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-id">id</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div><p>The <code translate="no" dir="ltr">id</code> of the <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> that changed.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-mime">mime</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-StringDelta">StringDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">mime</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-paused">paused</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-BooleanDelta">BooleanDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">paused</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-startTime">startTime</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-StringDelta">StringDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">startTime</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-state">state</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-StringDelta">StringDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">state</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-totalBytes">totalBytes</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-DoubleDelta">DoubleDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">totalBytes</code>, if any.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadDelta-url">url</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-StringDelta">StringDelta</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The change in <code translate="no" dir="ltr">url</code>, if any.</p> </li></ul> </div><div> <div class="notranslate"> <h3 id="type-DownloadItem" data-text="DownloadItem" tabindex="-1">DownloadItem</h3> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="properties_3" data-text="Properties" tabindex="-1">Properties</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-byExtensionId">byExtensionId</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The identifier for the extension that initiated this download if this download was initiated by an extension. Does not change once it is set.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-byExtensionName">byExtensionName</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The localized name of the extension that initiated this download if this download was initiated by an extension. May change if the extension changes its name or if the user changes their locale.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-bytesReceived">bytesReceived</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div><p>Number of bytes received so far from the host, without considering file compression.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-canResume">canResume</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--boolean">boolean</p></div> </div><p>True if the download is in progress and paused, or else if it is interrupted and can be resumed starting from where it was interrupted.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-danger">danger</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-DangerType">DangerType</a></p></div> </div><p>Indication of whether this download is thought to be safe or known to be suspicious.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-endTime">endTime</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The time when the download ended in ISO 8601 format. May be passed directly to the Date constructor: <code translate="no" dir="ltr">chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})</code></p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-error">error</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-InterruptReason">InterruptReason</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Why the download was interrupted. Several kinds of HTTP errors may be grouped under one of the errors beginning with <code translate="no" dir="ltr">SERVER_</code>. Errors relating to the network begin with <code translate="no" dir="ltr">NETWORK_</code>, errors relating to the process of writing the file to the file system begin with <code translate="no" dir="ltr">FILE_</code>, and interruptions initiated by the user begin with <code translate="no" dir="ltr">USER_</code>.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-estimatedEndTime">estimatedEndTime</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Estimated time when the download will complete in ISO 8601 format. May be passed directly to the Date constructor: <code translate="no" dir="ltr">chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})</code></p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-exists">exists</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--boolean">boolean</p></div> </div><p>Whether the downloaded file still exists. This information may be out of date because Chrome does not automatically watch for file removal. Call <a href="#method-search"><code translate="no" dir="ltr">search</code></a>() in order to trigger the check for file existence. When the existence check completes, if the file has been deleted, then an <a href="#event-onChanged"><code translate="no" dir="ltr">onChanged</code></a> event will fire. Note that <a href="#method-search"><code translate="no" dir="ltr">search</code></a>() does not wait for the existence check to finish before returning, so results from <a href="#method-search"><code translate="no" dir="ltr">search</code></a>() may not accurately reflect the file system. Also, <a href="#method-search"><code translate="no" dir="ltr">search</code></a>() may be called as often as necessary, but will not check for file existence any more frequently than once every 10 seconds.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-fileSize">fileSize</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div><p>Number of bytes in the whole file post-decompression, or -1 if unknown.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-filename">filename</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string</p></div> </div><p>Absolute local path.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-finalUrl">finalUrl</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string</p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 54+ </span></div> </div><p>The absolute URL that this download is being made from, after all redirects.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-id">id</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div><p>An identifier that is persistent across browser sessions.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-incognito">incognito</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--boolean">boolean</p></div> </div><p>False if this download is recorded in the history, true if it is not recorded.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-mime">mime</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string</p></div> </div><p>The file's MIME type.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-paused">paused</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--boolean">boolean</p></div> </div><p>True if the download has stopped reading data from the host, but kept the connection open.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-referrer">referrer</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string</p></div> </div><p>Absolute URL.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-startTime">startTime</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string</p></div> </div><p>The time when the download began in ISO 8601 format. May be passed directly to the Date constructor: <code translate="no" dir="ltr">chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})</code></p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-state">state</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-State">State</a></p></div> </div><p>Indicates whether the download is progressing, interrupted, or complete.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-totalBytes">totalBytes</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div><p>Number of bytes in the whole file, without considering file compression, or -1 if unknown.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadItem-url">url</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string</p></div> </div><p>The absolute URL that this download initiated from, before any redirects.</p> </li></ul> </div><div> <div class="notranslate"> <h3 id="type-DownloadOptions" data-text="DownloadOptions" tabindex="-1">DownloadOptions</h3> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="properties_4" data-text="Properties" tabindex="-1">Properties</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadOptions-body">body</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Post body.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadOptions-conflictAction">conflictAction</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-FilenameConflictAction">FilenameConflictAction</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The action to take if <code translate="no" dir="ltr">filename</code> already exists.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadOptions-filename">filename</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>A file path relative to the Downloads directory to contain the downloaded file, possibly containing subdirectories. Absolute paths, empty paths, and paths containing back-references ".." will cause an error. <a href="#event-onDeterminingFilename"><code translate="no" dir="ltr">onDeterminingFilename</code></a> allows suggesting a filename after the file's MIME type and a tentative filename have been determined.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadOptions-headers">headers</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--array"><a href="#type-HeaderNameValuePair">HeaderNameValuePair</a>[] <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Extra HTTP headers to send with the request if the URL uses the HTTP[s] protocol. Each header is represented as a dictionary containing the keys <code translate="no" dir="ltr">name</code> and either <code translate="no" dir="ltr">value</code> or <code translate="no" dir="ltr">binaryValue</code>, restricted to those allowed by XMLHttpRequest.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadOptions-method">method</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-HttpMethod">HttpMethod</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The HTTP method to use if the URL uses the HTTP[S] protocol.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadOptions-saveAs">saveAs</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--boolean">boolean <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Use a file-chooser to allow the user to select a filename regardless of whether <code translate="no" dir="ltr">filename</code> is set or already exists.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadOptions-url">url</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string</p></div> </div><p>The URL to download.</p> </li></ul> </div><div> <div class="notranslate"> <h3 id="type-DownloadQuery" data-text="DownloadQuery" tabindex="-1">DownloadQuery</h3> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="properties_5" data-text="Properties" tabindex="-1">Properties</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-bytesReceived">bytesReceived</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Number of bytes received so far from the host, without considering file compression.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-danger">danger</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-DangerType">DangerType</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Indication of whether this download is thought to be safe or known to be suspicious.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-endTime">endTime</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The time when the download ended in ISO 8601 format.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-endedAfter">endedAfter</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Limits results to <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> that ended after the given ms in ISO 8601 format</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-endedBefore">endedBefore</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Limits results to <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> that ended before the given ms in ISO 8601 format.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-error">error</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-InterruptReason">InterruptReason</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Why a download was interrupted.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-exists">exists</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--boolean">boolean <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Whether the downloaded file exists;</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-fileSize">fileSize</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Number of bytes in the whole file post-decompression, or -1 if unknown.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-filename">filename</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Absolute local path.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-filenameRegex">filenameRegex</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Limits results to <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> whose <code translate="no" dir="ltr">filename</code> matches the given regular expression.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-finalUrl">finalUrl</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 54+ </span></div> </div><p>The absolute URL that this download is being made from, after all redirects.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-finalUrlRegex">finalUrlRegex</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 54+ </span></div> </div><p>Limits results to <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> whose <code translate="no" dir="ltr">finalUrl</code> matches the given regular expression.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-id">id</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The <code translate="no" dir="ltr">id</code> of the <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> to query.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-limit">limit</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The maximum number of matching <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> returned. Defaults to 1000. Set to 0 in order to return all matching <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a>. See <a href="#method-search"><code translate="no" dir="ltr">search</code></a> for how to page through results.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-mime">mime</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The file's MIME type.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-orderBy">orderBy</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--array">string[] <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Set elements of this array to <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> properties in order to sort search results. For example, setting <code translate="no" dir="ltr">orderBy=['startTime']</code> sorts the <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> by their start time in ascending order. To specify descending order, prefix with a hyphen: '-startTime'.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-paused">paused</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--boolean">boolean <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>True if the download has stopped reading data from the host, but kept the connection open.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-query">query</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--array">string[] <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>This array of search terms limits results to <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> whose <code translate="no" dir="ltr">filename</code> or <code translate="no" dir="ltr">url</code> or <code translate="no" dir="ltr">finalUrl</code> contain all of the search terms that do not begin with a dash '-' and none of the search terms that do begin with a dash.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-startTime">startTime</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The time when the download began in ISO 8601 format.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-startedAfter">startedAfter</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Limits results to <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> that started after the given ms in ISO 8601 format.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-startedBefore">startedBefore</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Limits results to <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> that started before the given ms in ISO 8601 format.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-state">state</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-State">State</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Indicates whether the download is progressing, interrupted, or complete.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-totalBytes">totalBytes</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Number of bytes in the whole file, without considering file compression, or -1 if unknown.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-totalBytesGreater">totalBytesGreater</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Limits results to <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> whose <code translate="no" dir="ltr">totalBytes</code> is greater than the given integer.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-totalBytesLess">totalBytesLess</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Limits results to <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> whose <code translate="no" dir="ltr">totalBytes</code> is less than the given integer.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-url">url</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The absolute URL that this download initiated from, before any redirects.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-DownloadQuery-urlRegex">urlRegex</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>Limits results to <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> whose <code translate="no" dir="ltr">url</code> matches the given regular expression.</p> </li></ul> </div><div> <div class="notranslate"> <h3 id="type-FilenameConflictAction" data-text="FilenameConflictAction" tabindex="-1">FilenameConflictAction</h3> </div><p>uniquify</p> <p>To avoid duplication, the <code translate="no" dir="ltr">filename</code> is changed to include a counter before the filename extension.</p> <p>overwrite</p> <p>The existing file will be overwritten with the new file.</p> <p>prompt</p> <p>The user will be prompted with a file chooser dialog.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="enum_1" data-text="Enum" tabindex="-1">Enum</h4><div class="dcc-code-sections__overline dcc-code-sections__label"> <p><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"uniquify"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"overwrite"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"prompt"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span></p> </div> </div><div> <div class="notranslate"> <h3 id="type-FilenameSuggestion" data-text="FilenameSuggestion" tabindex="-1">FilenameSuggestion</h3> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="properties_6" data-text="Properties" tabindex="-1">Properties</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-FilenameSuggestion-conflictAction">conflictAction</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-FilenameConflictAction">FilenameConflictAction</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The action to take if <code translate="no" dir="ltr">filename</code> already exists.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-FilenameSuggestion-filename">filename</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string</p></div> </div><p>The <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a>'s new target <a href="#property-DownloadItem-filename"><code translate="no" dir="ltr">DownloadItem.filename</code></a>, as a path relative to the user's default Downloads directory, possibly containing subdirectories. Absolute paths, empty paths, and paths containing back-references ".." will be ignored. <code translate="no" dir="ltr">filename</code> is ignored if there are any <a href="#event-onDeterminingFilename"><code translate="no" dir="ltr">onDeterminingFilename</code></a> listeners registered by any extensions.</p> </li></ul> </div><div> <div class="notranslate"> <h3 id="type-GetFileIconOptions" data-text="GetFileIconOptions" tabindex="-1">GetFileIconOptions</h3> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="properties_7" data-text="Properties" tabindex="-1">Properties</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-GetFileIconOptions-size">size</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number <span class="dcc-code-sections__optional">optional</span></p></div> </div><p>The size of the returned icon. The icon will be square with dimensions size * size pixels. The default and largest size for the icon is 32x32 pixels. The only supported sizes are 16 and 32. It is an error to specify any other size.</p> </li></ul> </div><div> <div class="notranslate"> <h3 id="type-HeaderNameValuePair" data-text="HeaderNameValuePair" tabindex="-1">HeaderNameValuePair</h3> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="properties_8" data-text="Properties" tabindex="-1">Properties</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-HeaderNameValuePair-name">name</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string</p></div> </div><p>Name of the HTTP header.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-HeaderNameValuePair-value">value</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string</p></div> </div><p>Value of the HTTP header.</p> </li></ul> </div><div> <div class="notranslate"> <h3 id="type-HttpMethod" data-text="HttpMethod" tabindex="-1">HttpMethod</h3> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="enum_2" data-text="Enum" tabindex="-1">Enum</h4><div class="dcc-code-sections__overline dcc-code-sections__label"> <p><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"GET"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"POST"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span></p> </div> </div><div> <div class="notranslate"> <h3 id="type-InterruptReason" data-text="InterruptReason" tabindex="-1">InterruptReason</h3> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="enum_3" data-text="Enum" tabindex="-1">Enum</h4><div class="dcc-code-sections__overline dcc-code-sections__label"> <p><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"FILE_FAILED"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"FILE_ACCESS_DENIED"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"FILE_NO_SPACE"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"FILE_NAME_TOO_LONG"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"FILE_TOO_LARGE"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"FILE_VIRUS_INFECTED"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"FILE_TRANSIENT_ERROR"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"FILE_BLOCKED"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"FILE_SECURITY_CHECK_FAILED"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"FILE_TOO_SHORT"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"FILE_HASH_MISMATCH"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"FILE_SAME_AS_SOURCE"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"NETWORK_FAILED"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"NETWORK_TIMEOUT"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"NETWORK_DISCONNECTED"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"NETWORK_SERVER_DOWN"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"NETWORK_INVALID_REQUEST"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"SERVER_FAILED"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"SERVER_NO_RANGE"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"SERVER_BAD_CONTENT"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"SERVER_UNAUTHORIZED"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"SERVER_CERT_PROBLEM"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"SERVER_FORBIDDEN"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"SERVER_UNREACHABLE"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"SERVER_CONTENT_LENGTH_MISMATCH"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"SERVER_CROSS_ORIGIN_REDIRECT"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"USER_CANCELED"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"USER_SHUTDOWN"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"CRASH"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span></p> </div> </div><div> <div class="notranslate"> <h3 id="type-State" data-text="State" tabindex="-1">State</h3> </div><p>in_progress</p> <p>The download is currently receiving data from the server.</p> <p>interrupted</p> <p>An error broke the connection with the file host.</p> <p>complete</p> <p>The download completed successfully.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="enum_4" data-text="Enum" tabindex="-1">Enum</h4><div class="dcc-code-sections__overline dcc-code-sections__label"> <p><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"in_progress"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"interrupted"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span><span style="white-space: nowrap;"><p class="dcc-code-sections__icon dcc-code-sections__icon--stringdcc-code-sections__enum"><span class="dcc-code-sections__value">"complete"</span> <br> <span class="dcc-type--xsmall" style="white-space: initial"></span></p></span></p> </div> </div><div> <div class="notranslate"> <h3 id="type-StringDelta" data-text="StringDelta" tabindex="-1">StringDelta</h3> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="properties_9" data-text="Properties" tabindex="-1">Properties</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-StringDelta-current">current</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div></li><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-StringDelta-previous">previous</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div></li></ul> </div><div> <div class="notranslate"> <h3 id="type-UiOptions" data-text="UiOptions" tabindex="-1">UiOptions</h3> </div><div class=""> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 105+ </span></div> </div></div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="properties_10" data-text="Properties" tabindex="-1">Properties</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="property-UiOptions-enabled">enabled</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--boolean">boolean</p></div> </div><p>Enable or disable the download UI.</p> </li></ul> </div></div><h2 id="method" data-text="Methods" tabindex="-1">Methods</h2> <div><div> <div class="notranslate"> <h3 id="method-acceptDanger" data-text="acceptDanger()" tabindex="-1">acceptDanger()</h3> </div><div class=""> <div><span class="dcc-tag-pill--green dcc-tag-pill" title="Can return its result via Promise in Manifest V3 or later."> Promise </span></div> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.acceptDanger(<br />  downloadId: number,<br />  callback?: function,<br />)</pre> </span><p>Prompt the user to accept a dangerous download. Can only be called from a visible context (tab, window, or page/browser action popup). Does not automatically accept dangerous downloads. If the download is accepted, then an <a href="#event-onChanged"><code translate="no" dir="ltr">onChanged</code></a> event will fire, otherwise nothing will happen. When all the data is fetched into a temporary file and either the download is not dangerous or the danger has been accepted, then the temporary file is renamed to the target filename, the <code translate="no" dir="ltr">state</code> changes to 'complete', and <a href="#event-onChanged"><code translate="no" dir="ltr">onChanged</code></a> fires.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-acceptDanger-downloadId">downloadId</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div><p>The identifier for the <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a>.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-acceptDanger-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function <span class="dcc-code-sections__optional">optional</span></p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">() => void</pre></span> </p></li></ul> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="returns" data-text="Returns" tabindex="-1">Returns</h4><ul class="stack"> <li class="stack"> <div><div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object">Promise<void></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 96+ </span></div> </div> <p> Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback. </p> </li> </ul> </div><div> <div class="notranslate"> <h3 id="method-cancel" data-text="cancel()" tabindex="-1">cancel()</h3> </div><div class=""> <div><span class="dcc-tag-pill--green dcc-tag-pill" title="Can return its result via Promise in Manifest V3 or later."> Promise </span></div> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.cancel(<br />  downloadId: number,<br />  callback?: function,<br />)</pre> </span><p>Cancel a download. When <code translate="no" dir="ltr">callback</code> is run, the download is cancelled, completed, interrupted or doesn't exist anymore.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_1" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-cancel-downloadId">downloadId</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div><p>The id of the download to cancel.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-cancel-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function <span class="dcc-code-sections__optional">optional</span></p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">() => void</pre></span> </p></li></ul> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="returns_1" data-text="Returns" tabindex="-1">Returns</h4><ul class="stack"> <li class="stack"> <div><div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object">Promise<void></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 96+ </span></div> </div> <p> Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback. </p> </li> </ul> </div><div> <div class="notranslate"> <h3 id="method-download" data-text="download()" tabindex="-1">download()</h3> </div><div class=""> <div><span class="dcc-tag-pill--green dcc-tag-pill" title="Can return its result via Promise in Manifest V3 or later."> Promise </span></div> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.download(<br />  options: <a href="#type-DownloadOptions">DownloadOptions</a>,<br />  callback?: function,<br />)</pre> </span><p>Download a URL. If the URL uses the HTTP[S] protocol, then the request will include all cookies currently set for its hostname. If both <code translate="no" dir="ltr">filename</code> and <code translate="no" dir="ltr">saveAs</code> are specified, then the Save As dialog will be displayed, pre-populated with the specified <code translate="no" dir="ltr">filename</code>. If the download started successfully, <code translate="no" dir="ltr">callback</code> will be called with the new <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a>'s <code translate="no" dir="ltr">downloadId</code>. If there was an error starting the download, then <code translate="no" dir="ltr">callback</code> will be called with <code translate="no" dir="ltr">downloadId=undefined</code> and <a href="https://developer.chrome.com/docs/extensions/reference/runtime/#property-lastError"><code translate="no" dir="ltr">runtime.lastError</code></a> will contain a descriptive string. The error strings are not guaranteed to remain backwards compatible between releases. Extensions must not parse it.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_2" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-download-options">options</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-DownloadOptions">DownloadOptions</a></p></div> </div><p>What to download and how.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-download-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function <span class="dcc-code-sections__optional">optional</span></p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">(downloadId: number) => void</pre></span> </p><div class="dcc-code-sections"><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-download-callback-downloadId">downloadId</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div></li></ul> </div></li></ul> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="returns_2" data-text="Returns" tabindex="-1">Returns</h4><ul class="stack"> <li class="stack"> <div><div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object">Promise<number></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 96+ </span></div> </div> <p> Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback. </p> </li> </ul> </div><div> <div class="notranslate"> <h3 id="method-erase" data-text="erase()" tabindex="-1">erase()</h3> </div><div class=""> <div><span class="dcc-tag-pill--green dcc-tag-pill" title="Can return its result via Promise in Manifest V3 or later."> Promise </span></div> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.erase(<br />  query: <a href="#type-DownloadQuery">DownloadQuery</a>,<br />  callback?: function,<br />)</pre> </span><p>Erase matching <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> from history without deleting the downloaded file. An <a href="#event-onErased"><code translate="no" dir="ltr">onErased</code></a> event will fire for each <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> that matches <code translate="no" dir="ltr">query</code>, then <code translate="no" dir="ltr">callback</code> will be called.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_3" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-erase-query">query</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-DownloadQuery">DownloadQuery</a></p></div> </div></li><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-erase-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function <span class="dcc-code-sections__optional">optional</span></p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">(erasedIds: number[]) => void</pre></span> </p><div class="dcc-code-sections"><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-erase-callback-erasedIds">erasedIds</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--array">number[]</p></div> </div></li></ul> </div></li></ul> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="returns_3" data-text="Returns" tabindex="-1">Returns</h4><ul class="stack"> <li class="stack"> <div><div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object">Promise<number[]></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 96+ </span></div> </div> <p> Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback. </p> </li> </ul> </div><div> <div class="notranslate"> <h3 id="method-getFileIcon" data-text="getFileIcon()" tabindex="-1">getFileIcon()</h3> </div><div class=""> <div><span class="dcc-tag-pill--green dcc-tag-pill" title="Can return its result via Promise in Manifest V3 or later."> Promise </span></div> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.getFileIcon(<br />  downloadId: number,<br />  options?: <a href="#type-GetFileIconOptions">GetFileIconOptions</a>,<br />  callback?: function,<br />)</pre> </span><p>Retrieve an icon for the specified download. For new downloads, file icons are available after the <a href="#event-onCreated"><code translate="no" dir="ltr">onCreated</code></a> event has been received. The image returned by this function while a download is in progress may be different from the image returned after the download is complete. Icon retrieval is done by querying the underlying operating system or toolkit depending on the platform. The icon that is returned will therefore depend on a number of factors including state of the download, platform, registered file types and visual theme. If a file icon cannot be determined, <a href="https://developer.chrome.com/docs/extensions/reference/runtime/#property-lastError"><code translate="no" dir="ltr">runtime.lastError</code></a> will contain an error message.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_4" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-getFileIcon-downloadId">downloadId</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div><p>The identifier for the download.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-getFileIcon-options">options</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-GetFileIconOptions">GetFileIconOptions</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div></li><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-getFileIcon-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function <span class="dcc-code-sections__optional">optional</span></p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">(iconURL?: string) => void</pre></span> </p><div class="dcc-code-sections"><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-getFileIcon-callback-iconURL">iconURL</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--string">string <span class="dcc-code-sections__optional">optional</span></p></div> </div></li></ul> </div></li></ul> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="returns_4" data-text="Returns" tabindex="-1">Returns</h4><ul class="stack"> <li class="stack"> <div><div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object">Promise<string | undefined></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 96+ </span></div> </div> <p> Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback. </p> </li> </ul> </div><div> <div class="notranslate"> <h3 id="method-open" data-text="open()" tabindex="-1">open()</h3> </div><div class=""> <div><span class="dcc-tag-pill--green dcc-tag-pill" title="Can return its result via Promise in Manifest V3 or later."> Promise </span></div> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.open(<br />  downloadId: number,<br />  callback?: function,<br />)</pre> </span><p>Opens the downloaded file now if the <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> is complete; otherwise returns an error through <a href="https://developer.chrome.com/docs/extensions/reference/runtime/#property-lastError"><code translate="no" dir="ltr">runtime.lastError</code></a>. This method requires the <code translate="no" dir="ltr">"downloads.open"</code> permission in addition to the <code translate="no" dir="ltr">"downloads"</code> permission. An <a href="#event-onChanged"><code translate="no" dir="ltr">onChanged</code></a> event fires when the item is opened for the first time. This method can only be called in response to a user gesture.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_5" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-open-downloadId">downloadId</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div><p>The identifier for the downloaded file.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-open-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function <span class="dcc-code-sections__optional">optional</span></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 123+ </span></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">() => void</pre></span> </p></li></ul> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="returns_5" data-text="Returns" tabindex="-1">Returns</h4><ul class="stack"> <li class="stack"> <div><div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object">Promise<void></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 123+ </span></div> </div> <p> Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback. </p> </li> </ul> </div><div> <div class="notranslate"> <h3 id="method-pause" data-text="pause()" tabindex="-1">pause()</h3> </div><div class=""> <div><span class="dcc-tag-pill--green dcc-tag-pill" title="Can return its result via Promise in Manifest V3 or later."> Promise </span></div> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.pause(<br />  downloadId: number,<br />  callback?: function,<br />)</pre> </span><p>Pause the download. If the request was successful the download is in a paused state. Otherwise <a href="https://developer.chrome.com/docs/extensions/reference/runtime/#property-lastError"><code translate="no" dir="ltr">runtime.lastError</code></a> contains an error message. The request will fail if the download is not active.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_6" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-pause-downloadId">downloadId</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div><p>The id of the download to pause.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-pause-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function <span class="dcc-code-sections__optional">optional</span></p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">() => void</pre></span> </p></li></ul> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="returns_6" data-text="Returns" tabindex="-1">Returns</h4><ul class="stack"> <li class="stack"> <div><div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object">Promise<void></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 96+ </span></div> </div> <p> Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback. </p> </li> </ul> </div><div> <div class="notranslate"> <h3 id="method-removeFile" data-text="removeFile()" tabindex="-1">removeFile()</h3> </div><div class=""> <div><span class="dcc-tag-pill--green dcc-tag-pill" title="Can return its result via Promise in Manifest V3 or later."> Promise </span></div> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.removeFile(<br />  downloadId: number,<br />  callback?: function,<br />)</pre> </span><p>Remove the downloaded file if it exists and the <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> is complete; otherwise return an error through <a href="https://developer.chrome.com/docs/extensions/reference/runtime/#property-lastError"><code translate="no" dir="ltr">runtime.lastError</code></a>.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_7" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-removeFile-downloadId">downloadId</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div></li><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-removeFile-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function <span class="dcc-code-sections__optional">optional</span></p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">() => void</pre></span> </p></li></ul> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="returns_7" data-text="Returns" tabindex="-1">Returns</h4><ul class="stack"> <li class="stack"> <div><div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object">Promise<void></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 96+ </span></div> </div> <p> Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback. </p> </li> </ul> </div><div> <div class="notranslate"> <h3 id="method-resume" data-text="resume()" tabindex="-1">resume()</h3> </div><div class=""> <div><span class="dcc-tag-pill--green dcc-tag-pill" title="Can return its result via Promise in Manifest V3 or later."> Promise </span></div> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.resume(<br />  downloadId: number,<br />  callback?: function,<br />)</pre> </span><p>Resume a paused download. If the request was successful the download is in progress and unpaused. Otherwise <a href="https://developer.chrome.com/docs/extensions/reference/runtime/#property-lastError"><code translate="no" dir="ltr">runtime.lastError</code></a> contains an error message. The request will fail if the download is not active.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_8" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-resume-downloadId">downloadId</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div><p>The id of the download to resume.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-resume-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function <span class="dcc-code-sections__optional">optional</span></p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">() => void</pre></span> </p></li></ul> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="returns_8" data-text="Returns" tabindex="-1">Returns</h4><ul class="stack"> <li class="stack"> <div><div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object">Promise<void></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 96+ </span></div> </div> <p> Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback. </p> </li> </ul> </div><div> <div class="notranslate"> <h3 id="method-search" data-text="search()" tabindex="-1">search()</h3> </div><div class=""> <div><span class="dcc-tag-pill--green dcc-tag-pill" title="Can return its result via Promise in Manifest V3 or later."> Promise </span></div> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.search(<br />  query: <a href="#type-DownloadQuery">DownloadQuery</a>,<br />  callback?: function,<br />)</pre> </span><p>Find <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a>. Set <code translate="no" dir="ltr">query</code> to the empty object to get all <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a>. To get a specific <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a>, set only the <code translate="no" dir="ltr">id</code> field. To page through a large number of items, set <code translate="no" dir="ltr">orderBy: ['-startTime']</code>, set <code translate="no" dir="ltr">limit</code> to the number of items per page, and set <code translate="no" dir="ltr">startedAfter</code> to the <code translate="no" dir="ltr">startTime</code> of the last item from the last page.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_9" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-search-query">query</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-DownloadQuery">DownloadQuery</a></p></div> </div></li><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-search-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function <span class="dcc-code-sections__optional">optional</span></p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">(results: <a href="#type-DownloadItem">DownloadItem</a>[]) => void</pre></span> </p><div class="dcc-code-sections"><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-search-callback-results">results</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--array"><a href="#type-DownloadItem">DownloadItem</a>[]</p></div> </div></li></ul> </div></li></ul> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="returns_9" data-text="Returns" tabindex="-1">Returns</h4><ul class="stack"> <li class="stack"> <div><div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object">Promise<<a href="#type-DownloadItem">DownloadItem</a>[]></p></div> </div><div class="pad-top-200"> <div><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 96+ </span></div> </div> <p> Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback. </p> </li> </ul> </div><div> <div class="notranslate"> <h3 id="method-setShelfEnabled" data-text="setShelfEnabled()" tabindex="-1">setShelfEnabled()</h3> </div><div class=""> <div><span class="dcc-tag-pill--red dcc-tag-pill"> Deprecated since Chrome 117</span></div> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.setShelfEnabled(<br />  enabled: boolean,<br />)</pre> </span><p class="dcc-code-sections__deprecated">Use <a href="#method-setUiOptions"><code translate="no" dir="ltr">setUiOptions</code></a> instead.<p><p>Enable or disable the gray shelf at the bottom of every window associated with the current browser profile. The shelf will be disabled as long as at least one extension has disabled it. Enabling the shelf while at least one other extension has disabled it will return an error through <a href="https://developer.chrome.com/docs/extensions/reference/runtime/#property-lastError"><code translate="no" dir="ltr">runtime.lastError</code></a>. Requires the <code translate="no" dir="ltr">"downloads.shelf"</code> permission in addition to the <code translate="no" dir="ltr">"downloads"</code> permission.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_10" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-setShelfEnabled-enabled">enabled</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--boolean">boolean</p></div> </div></li></ul> </div><div> <div class="notranslate"> <h3 id="method-setUiOptions" data-text="setUiOptions()" tabindex="-1">setUiOptions()</h3> </div><div class=""> <div><span class="dcc-tag-pill--green dcc-tag-pill" title="Can return its result via Promise in Manifest V3 or later."> Promise </span><span class="dcc-tag-pill--blue dcc-tag-pill" title="Available from this Chrome version and higher">Chrome 105+ </span></div> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.setUiOptions(<br />  options: <a href="#type-UiOptions">UiOptions</a>,<br />  callback?: function,<br />)</pre> </span><p>Change the download UI of every window associated with the current browser profile. As long as at least one extension has set <a href="#property-UiOptions-enabled"><code translate="no" dir="ltr">UiOptions.enabled</code></a> to false, the download UI will be hidden. Setting <a href="#property-UiOptions-enabled"><code translate="no" dir="ltr">UiOptions.enabled</code></a> to true while at least one other extension has disabled it will return an error through <a href="https://developer.chrome.com/docs/extensions/reference/runtime/#property-lastError"><code translate="no" dir="ltr">runtime.lastError</code></a>. Requires the <code translate="no" dir="ltr">"downloads.ui"</code> permission in addition to the <code translate="no" dir="ltr">"downloads"</code> permission.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_11" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-setUiOptions-options">options</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-UiOptions">UiOptions</a></p></div> </div><p>Encapsulate a change to the download UI.</p> </li><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-setUiOptions-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function <span class="dcc-code-sections__optional">optional</span></p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">() => void</pre></span> </p></li></ul> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="returns_10" data-text="Returns" tabindex="-1">Returns</h4><ul class="stack"> <li class="stack"> <div><div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object">Promise<void></p></div> </div> <p> Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback. </p> </li> </ul> </div><div> <div class="notranslate"> <h3 id="method-show" data-text="show()" tabindex="-1">show()</h3> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.show(<br />  downloadId: number,<br />)</pre> </span><p>Show the downloaded file in its folder in a file manager.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_12" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-show-downloadId">downloadId</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div><p>The identifier for the downloaded file.</p> </li></ul> </div><div> <div class="notranslate"> <h3 id="method-showDefaultFolder" data-text="showDefaultFolder()" tabindex="-1">showDefaultFolder()</h3> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.showDefaultFolder()</pre> </span><p>Show the default Downloads folder in a file manager.</p> </div></div><h2 id="event" data-text="Events" tabindex="-1">Events</h2> <div><div> <div class="notranslate"> <h3 id="event-onChanged" data-text="onChanged" tabindex="-1">onChanged</h3> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.onChanged.addListener(<br />  callback: function,<br />)</pre> </span><p>When any of a <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a>'s properties except <code translate="no" dir="ltr">bytesReceived</code> and <code translate="no" dir="ltr">estimatedEndTime</code> changes, this event fires with the <code translate="no" dir="ltr">downloadId</code> and an object containing the properties that changed.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_13" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-onChanged-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function</p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">(downloadDelta: <a href="#type-DownloadDelta">DownloadDelta</a>) => void</pre></span> </p><div class="dcc-code-sections"><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-onChanged-callback-downloadDelta">downloadDelta</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-DownloadDelta">DownloadDelta</a></p></div> </div></li></ul> </div></li></ul> </div><div> <div class="notranslate"> <h3 id="event-onCreated" data-text="onCreated" tabindex="-1">onCreated</h3> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.onCreated.addListener(<br />  callback: function,<br />)</pre> </span><p>This event fires with the <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> object when a download begins.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_14" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-onCreated-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function</p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">(downloadItem: <a href="#type-DownloadItem">DownloadItem</a>) => void</pre></span> </p><div class="dcc-code-sections"><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-onCreated-callback-downloadItem">downloadItem</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-DownloadItem">DownloadItem</a></p></div> </div></li></ul> </div></li></ul> </div><div> <div class="notranslate"> <h3 id="event-onDeterminingFilename" data-text="onDeterminingFilename" tabindex="-1">onDeterminingFilename</h3> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.onDeterminingFilename.addListener(<br />  callback: function,<br />)</pre> </span><p>During the filename determination process, extensions will be given the opportunity to override the target <a href="#property-DownloadItem-filename"><code translate="no" dir="ltr">DownloadItem.filename</code></a>. Each extension may not register more than one listener for this event. Each listener must call <code translate="no" dir="ltr">suggest</code> exactly once, either synchronously or asynchronously. If the listener calls <code translate="no" dir="ltr">suggest</code> asynchronously, then it must return <code translate="no" dir="ltr">true</code>. If the listener neither calls <code translate="no" dir="ltr">suggest</code> synchronously nor returns <code translate="no" dir="ltr">true</code>, then <code translate="no" dir="ltr">suggest</code> will be called automatically. The <a href="#type-DownloadItem"><code translate="no" dir="ltr">DownloadItem</code></a> will not complete until all listeners have called <code translate="no" dir="ltr">suggest</code>. Listeners may call <code translate="no" dir="ltr">suggest</code> without any arguments in order to allow the download to use <code translate="no" dir="ltr">downloadItem.filename</code> for its filename, or pass a <code translate="no" dir="ltr">suggestion</code> object to <code translate="no" dir="ltr">suggest</code> in order to override the target filename. If more than one extension overrides the filename, then the last extension installed whose listener passes a <code translate="no" dir="ltr">suggestion</code> object to <code translate="no" dir="ltr">suggest</code> wins. In order to avoid confusion regarding which extension will win, users should not install extensions that may conflict. If the download is initiated by <a href="#method-download"><code translate="no" dir="ltr">download</code></a> and the target filename is known before the MIME type and tentative filename have been determined, pass <code translate="no" dir="ltr">filename</code> to <a href="#method-download"><code translate="no" dir="ltr">download</code></a> instead.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_15" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-onDeterminingFilename-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function</p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">(downloadItem: <a href="#type-DownloadItem">DownloadItem</a>, suggest: function) => void</pre></span> </p><div class="dcc-code-sections"><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-onDeterminingFilename-callback-downloadItem">downloadItem</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-DownloadItem">DownloadItem</a></p></div> </div></li><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-onDeterminingFilename-callback-suggest">suggest</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function</p></div> </div><p> The <code translate="no" dir="ltr">suggest</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">(suggestion?: <a href="#type-FilenameSuggestion">FilenameSuggestion</a>) => void</pre></span> </p><div class="dcc-code-sections"><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-onDeterminingFilename-callback-suggest-suggestion">suggestion</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--object"><a href="#type-FilenameSuggestion">FilenameSuggestion</a> <span class="dcc-code-sections__optional">optional</span></p></div> </div></li></ul> </div></li></ul> </div></li></ul> </div><div> <div class="notranslate"> <h3 id="event-onErased" data-text="onErased" tabindex="-1">onErased</h3> </div><span class="dcc-code-sections__callback dcc-type--xsmall"> <pre class="prettyprint lang-ts" translate="no" dir="ltr">chrome.downloads.onErased.addListener(<br />  callback: function,<br />)</pre> </span><p>Fires with the <code translate="no" dir="ltr">downloadId</code> when a download is erased from history.</p> </div><div class="dcc-code-sections"><h4 class="dcc-type--label dcc-code-sections__mode" id="parameters_16" data-text="Parameters" tabindex="-1">Parameters</h4><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="method-onErased-callback">callback</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--function">function</p></div> </div><p> The <code translate="no" dir="ltr">callback</code> parameter looks like: <span class="dcc-code-sections__callback dcc-type--xsmall"><pre class="prettyprint lang-ts" translate="no" dir="ltr">(downloadId: number) => void</pre></span> </p><div class="dcc-code-sections"><ul class="stack"><li class="stack"> <div> <div class="dcc-code-sections__label" id="type-onErased-callback-downloadId">downloadId</div> <div class="dcc-type--xsmall"><p class="dcc-code-sections__icon dcc-code-sections__icon--number">number</p></div> </div></li></ul> </div></li></ul> </div></div></div> </p> </div> <devsite-thumb-rating position="footer"> </devsite-thumb-rating> <div class="devsite-floating-action-buttons"> </div> </article> <devsite-content-footer class="nocontent"> <p>Except as otherwise noted, the content of this page is licensed under the <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://developers.google.com/site-policies">Google Developers Site Policies</a>. Java is a registered trademark of Oracle and/or its affiliates.</p> <p>Last updated 2024-10-15 UTC.</p> </devsite-content-footer> <devsite-notification > </devsite-notification> <div class="devsite-content-data"> <template class="devsite-content-data-template"> [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-15 UTC."],[],[]] </template> </div> </devsite-content> </main> <devsite-footer-promos class="devsite-footer"> </devsite-footer-promos> <devsite-footer-linkboxes class="devsite-footer"> <nav class="devsite-footer-linkboxes nocontent" aria-label="Footer links"> <ul class="devsite-footer-linkboxes-list"> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Contribute</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues/new?component=1400036&template=1897236" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > File a bug </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://issuetracker.google.com/issues?q=status:open%20componentid:1400036&s=created_time:desc" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > See open issues </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Related content</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://blog.chromium.org/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Chromium updates </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/case-studies" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Case studies </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/deprecated" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Archive </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://web.dev/shows" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" > Podcasts & shows </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Follow</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://twitter.com/ChromiumDev" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > @ChromiumDev on X </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://www.youtube.com/user/ChromeDevelopers" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > YouTube </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://www.linkedin.com/showcase/chrome-for-developers" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Chrome for Developers on LinkedIn </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/static/blog/feed.xml" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" > RSS </a> </li> </ul> </li> </ul> </nav> </devsite-footer-linkboxes> <devsite-footer-utility class="devsite-footer"> <div class="devsite-footer-utility nocontent"> <nav class="devsite-footer-utility-links" aria-label="Utility links"> <ul class="devsite-footer-utility-list"> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//policies.google.com/terms" data-category="Site-Wide Custom Events" data-label="Footer Terms link" > Terms </a> </li> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link" > Privacy </a> </li> <li class="devsite-footer-utility-item glue-cookie-notification-bar-control"> <a class="devsite-footer-utility-link gc-analytics-event" href="#" data-category="Site-Wide Custom Events" data-label="Footer Manage cookies link" aria-hidden="true" > Manage cookies </a> </li> </ul> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="nl" >Nederlands</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> </nav> </div> </devsite-footer-utility> <devsite-panel></devsite-panel> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar></devsite-snackbar> <devsite-tooltip ></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics> <script type="application/json" analytics>[]</script> <script type="application/json" tag-management>{"at": "True", "ga4": [], "ga4p": [], "gtm": [{"id": "GTM-5QF3RT2", "purpose": 0}], "parameters": {"internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "article", "projectName": "API", "signedIn": "False", "tenant": "chrome", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}, "experiment": {"ids": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <script nonce="yO1svPNtclk5ozsPzRJk3tkCqE4Tkq"> (function(d,e,v,s,i,t,E){d['GoogleDevelopersObject']=i; t=e.createElement(v);t.async=1;t.src=s;E=e.getElementsByTagName(v)[0]; E.parentNode.insertBefore(t,E);})(window, document, 'script', 'https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/chrome/js/app_loader.js', '[53,"en",null,"/js/devsite_app_module.js","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/chrome","https://chrome-dot-devsite-v2-prod-3p.appspot.com",null,null,["/_pwa/chrome/manifest.json","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/images/video-placeholder.svg","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/chrome/images/favicon.png","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/chrome/images/lockup.svg","https://fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"],1,null,[1,6,8,12,14,17,21,25,50,52,63,70,75,76,80,87,91,92,93,97,98,100,101,102,103,104,105,107,108,109,110,112,113,117,118,120,122,124,125,126,127,129,130,131,132,133,134,135,136,138,140,141,147,148,149,151,152,156,157,158,159,161,163,164,168,169,170,179,180,182,183,186,191,193,196],"AIzaSyCNm9YxQumEXwGJgTDjxoxXK6m1F-9720Q","AIzaSyCc76DZePGtoyUjqKrLdsMGk_ry7sljLbY","developer.chrome.com","AIzaSyB9bqgQ2t11WJsOX8qNsCQ6U-w91mmqF-I","AIzaSyAdYnStPdzjcJJtQ0mvIaeaMKj7_t6J_Fg",null,null,null,["DevPro__enable_developer_subscriptions","Profiles__enable_public_developer_profiles","Search__enable_page_map","MiscFeatureFlags__developers_footer_dark_image","Cloud__enable_cloud_shell","Search__enable_ai_eligibility_checks","Analytics__enable_clearcut_logging","Profiles__require_profile_eligibility_for_signin","MiscFeatureFlags__emergency_css","Cloud__enable_legacy_calculator_redirect","TpcFeatures__enable_mirror_tenant_redirects","Cloud__enable_llm_concierge_chat","MiscFeatureFlags__developers_footer_image","Profiles__enable_release_notes_notifications","Cloud__enable_cloud_shell_fte_user_flow","Experiments__reqs_query_experiments","MiscFeatureFlags__enable_explain_this_code","Search__enable_dynamic_content_confidential_banner","Cloud__enable_cloud_dlp_service","Profiles__enable_complete_playlist_endpoint","Profiles__enable_awarding_url","MiscFeatureFlags__enable_project_variables","BookNav__enable_tenant_cache_key","OnSwitch__enable","Profiles__enable_profile_collections","CloudShell__cloud_shell_button","Concierge__enable_pushui","Profiles__enable_dashboard_curated_recommendations","Cloud__enable_cloudx_experiment_ids","Cloud__enable_free_trial_server_call","Cloud__enable_cloudx_ping","Profiles__enable_developer_profiles_callout","Profiles__enable_page_saving","TpcFeatures__enable_required_headers","MiscFeatureFlags__enable_view_transitions","Cloud__enable_cloud_facet_chat","MiscFeatureFlags__enable_firebase_utm","CloudShell__cloud_code_overflow_menu","Profiles__enable_recognition_badges","DevPro__enable_cloud_innovators_plus","EngEduTelemetry__enable_engedu_telemetry","MiscFeatureFlags__enable_variable_operator","Profiles__enable_completecodelab_endpoint","Search__enable_suggestions_from_borg"],null,null,"AIzaSyA58TaKli1DculwmAmbpzLVGuWc8eCQgQc","https://developerscontentserving-pa.googleapis.com","AIzaSyDWBU60w0P9hEkr29kkksYs8Z7gvZ8u_wc","https://developerscontentsearch-pa.googleapis.com",2,4,null,"https://developerprofiles-pa.googleapis.com",[53,"chrome","Chrome for Developers","developer.chrome.com",null,"chrome-dot-devsite-v2-prod-3p.appspot.com",null,null,[null,null,null,null,null,null,null,null,null,null,null,[1],null,null,null,null,null,null,[1],null,null,null,null,[1,null,1],[1,1,null,1,1]],null,[69,null,null,null,null,null,"/images/lockup.svg","/images/touchicon-180.png",null,null,null,1,1,null,null,null,null,null,null,null,null,2,null,null,null,"/images/lockup-dark-theme.svg",[]],[],null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,[[],[1,1]],[[null,null,null,null,null,["GTM-5QF3RT2"],null,null,null,null,null,[["GTM-5QF3RT2",1]],1]],null,4]]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html>

CINXE.COM

chrome.downloads | API | Chrome for Developers