-DownloadItem* GetActiveItemInternal(

- Profile* profile,

- bool include_incognito,

- int id) {

-} // namespace

-

-bool DownloadsFunctionInterface::RunImplImpl(

- DownloadsFunctionInterface* pimpl) {

- CHECK(pimpl);

- if (!pimpl->ParseArgs()) return false;

- UMA_HISTOGRAM_ENUMERATION(

- "Download.ApiFunctions", pimpl->function(), DOWNLOADS_FUNCTION_LAST);

- return pimpl->RunInternal();

-}

-

-SyncDownloadsFunction::SyncDownloadsFunction(

- DownloadsFunctionInterface::DownloadsFunctionName function)

- : function_(function) {

-}

-

-SyncDownloadsFunction::~SyncDownloadsFunction() {}

-bool SyncDownloadsFunction::RunImpl() {

- return DownloadsFunctionInterface::RunImplImpl(this);

-DownloadsFunctionInterface::DownloadsFunctionName

-SyncDownloadsFunction::function() const {

- return function_;

-}

-DownloadItem* SyncDownloadsFunction::GetActiveItem(int download_id) {

- return GetActiveItemInternal(profile(), include_incognito(), download_id);

-AsyncDownloadsFunction::AsyncDownloadsFunction(

- DownloadsFunctionInterface::DownloadsFunctionName function)

- : function_(function) {

-}

-AsyncDownloadsFunction::~AsyncDownloadsFunction() {}

-bool AsyncDownloadsFunction::RunImpl() {

- return DownloadsFunctionInterface::RunImplImpl(this);

-}

-DownloadsFunctionInterface::DownloadsFunctionName

-AsyncDownloadsFunction::function() const {

- return function_;

-}

-DownloadItem* AsyncDownloadsFunction::GetActiveItem(int download_id) {

- return GetActiveItemInternal(profile(), include_incognito(), download_id);

-DownloadsDownloadFunction::DownloadsDownloadFunction()

- : AsyncDownloadsFunction(DOWNLOADS_FUNCTION_DOWNLOAD) {

-}

-DownloadsDownloadFunction::IOData::IOData()

- : save_as(false),

- extra_headers(NULL),

- method("GET"),

- rdh(NULL),

- resource_context(NULL),

- render_process_host_id(0),

- render_view_host_routing_id(0) {

-}

-

-DownloadsDownloadFunction::IOData::~IOData() {}

-

-bool DownloadsDownloadFunction::ParseArgs() {

- base::DictionaryValue* options = NULL;

- std::string url;

- iodata_.reset(new IOData());

- EXTENSION_FUNCTION_VALIDATE(args_->GetDictionary(0, &options));

- EXTENSION_FUNCTION_VALIDATE(options->GetString(kUrlKey, &url));

- iodata_->url = GURL(url);

- if (!iodata_->url.is_valid()) {

- error_ = download_extension_errors::kInvalidURLError;

- return false;

- }

-

- if (!iodata_->url.SchemeIs("data") &&

- iodata_->url.GetOrigin() != GetExtension()->url().GetOrigin() &&

- !GetExtension()->HasHostPermission(iodata_->url)) {

- if (options->HasKey(kFilenameKey)) {

- EXTENSION_FUNCTION_VALIDATE(options->GetString(

- kFilenameKey, &iodata_->filename));

- if (!ValidateFilename(iodata_->filename)) {

- }

-

- if (options->HasKey(kSaveAsKey)) {

- EXTENSION_FUNCTION_VALIDATE(options->GetBoolean(

- kSaveAsKey, &iodata_->save_as));

- }

-

- if (options->HasKey(kMethodKey)) {

- EXTENSION_FUNCTION_VALIDATE(options->GetString(

- kMethodKey, &iodata_->method));

- }

-

- // It's ok to use a pointer to extra_headers without DeepCopy()ing because

- // |args_| (which owns *extra_headers) is guaranteed to live as long as

- // |this|.

- if (options->HasKey(kHeadersKey)) {

- EXTENSION_FUNCTION_VALIDATE(options->GetList(

- kHeadersKey, &iodata_->extra_headers));

- }

-

- if (options->HasKey(kBodyKey)) {

- EXTENSION_FUNCTION_VALIDATE(options->GetString(

- kBodyKey, &iodata_->post_body));

- }

-

- if (iodata_->extra_headers != NULL) {

- for (size_t index = 0; index < iodata_->extra_headers->GetSize(); ++index) {

- base::DictionaryValue* header = NULL;

- std::string name;

- EXTENSION_FUNCTION_VALIDATE(iodata_->extra_headers->GetDictionary(

- index, &header));

- EXTENSION_FUNCTION_VALIDATE(header->GetString(

- kHeaderNameKey, &name));

- if (!net::HttpUtil::IsSafeHeader(name)) {

- iodata_->rdh = content::ResourceDispatcherHost::Get();

- iodata_->resource_context = profile()->GetResourceContext();

- iodata_->render_process_host_id = render_view_host()->GetProcess()->GetID();

- iodata_->render_view_host_routing_id = render_view_host()->GetRoutingID();

- return true;

-}

-

-bool DownloadsDownloadFunction::RunInternal() {

- VLOG(1) << __FUNCTION__ << " " << iodata_->url.spec();

- if (!BrowserThread::PostTask(BrowserThread::IO, FROM_HERE, base::Bind(

- &DownloadsDownloadFunction::BeginDownloadOnIOThread, this))) {

- error_ = download_extension_errors::kGenericError;

- return false;

- }

- return true;

-}

-

-void DownloadsDownloadFunction::BeginDownloadOnIOThread() {

- DCHECK(BrowserThread::CurrentlyOn(BrowserThread::IO));

- DVLOG(1) << __FUNCTION__ << " " << iodata_->url.spec();

- content::DownloadSaveInfo save_info;

- // TODO(benjhayden) Ensure that this filename is interpreted as a path

- // relative to the default downloads directory without allowing '..'.

- save_info.suggested_name = iodata_->filename;

- save_info.prompt_for_save_location = iodata_->save_as;

-

- scoped_ptr<net::URLRequest> request(new net::URLRequest(

- iodata_->url,

- NULL,

- iodata_->resource_context->GetRequestContext()));

- request->set_method(iodata_->method);

- if (iodata_->extra_headers != NULL) {

- for (size_t index = 0; index < iodata_->extra_headers->GetSize(); ++index) {

- base::DictionaryValue* header = NULL;

- std::string name, value;

- CHECK(iodata_->extra_headers->GetDictionary(index, &header));

- CHECK(header->GetString(kHeaderNameKey, &name));

- CHECK(header->GetString(kHeaderValueKey, &value));

- request->SetExtraRequestHeaderByName(name, value, false/*overwrite*/);

- }

- }

- if (!iodata_->post_body.empty()) {

- request->AppendBytesToUpload(iodata_->post_body.data(),

- iodata_->post_body.size());

- }

- request->set_load_flags(request->load_flags() |

- net::LOAD_DO_NOT_PROMPT_FOR_LOGIN);

-

- net::Error error = iodata_->rdh->BeginDownload(

- request.Pass(),

- false, // is_content_initiated

- iodata_->resource_context,

- iodata_->render_process_host_id,

- iodata_->render_view_host_routing_id,

- false, // prefer_cache

- save_info,

- base::Bind(&DownloadsDownloadFunction::OnStarted, this));

- iodata_.reset();

-

- if (error != net::OK) {

- BrowserThread::PostTask(

- BrowserThread::UI, FROM_HERE,

- base::Bind(&DownloadsDownloadFunction::OnStarted, this,

- DownloadId::Invalid(), error));

- }

-DownloadsSearchFunction::DownloadsSearchFunction()

- : SyncDownloadsFunction(DOWNLOADS_FUNCTION_SEARCH),

- query_(new DownloadQuery()),

- get_id_(0),

- has_get_id_(false) {

-}

-

-bool DownloadsSearchFunction::ParseArgs() {

- static base::LazyInstance<FilterTypeMap> filter_types =

- LAZY_INSTANCE_INITIALIZER;

- if (filter_types.Get().size() == 0)

- InitFilterTypeMap(filter_types.Get());

-

- base::DictionaryValue* query_json = NULL;

- EXTENSION_FUNCTION_VALIDATE(args_->GetDictionary(0, &query_json));

- for (base::DictionaryValue::Iterator query_json_field(*query_json);

- query_json_field.HasNext(); query_json_field.Advance()) {

- FilterTypeMap::const_iterator filter_type =

- filter_types.Get().find(query_json_field.key());

-

- if (filter_type != filter_types.Get().end()) {

- if (!query_->AddFilter(filter_type->second, query_json_field.value())) {

- error_ = download_extension_errors::kInvalidFilterError;

- return false;

- }

- } else if (query_json_field.key() == kIdKey) {

- EXTENSION_FUNCTION_VALIDATE(query_json_field.value().GetAsInteger(

- &get_id_));

- has_get_id_ = true;

- } else if (query_json_field.key() == kOrderByKey) {

- if (!ParseOrderBy(query_json_field.value()))

- return false;

- } else if (query_json_field.key() == kDangerKey) {

- std::string danger_str;

- EXTENSION_FUNCTION_VALIDATE(query_json_field.value().GetAsString(

- &danger_str));

- content::DownloadDangerType danger_type =

- DangerEnumFromString(danger_str);

- if (danger_type == content::DOWNLOAD_DANGER_TYPE_MAX) {

- error_ = download_extension_errors::kInvalidDangerTypeError;

- return false;

- }

- query_->AddFilter(danger_type);

- } else if (query_json_field.key() == kStateKey) {

- std::string state_str;

- EXTENSION_FUNCTION_VALIDATE(query_json_field.value().GetAsString(

- &state_str));

- DownloadItem::DownloadState state = StateEnumFromString(state_str);

- if (state == DownloadItem::MAX_DOWNLOAD_STATE) {

- error_ = download_extension_errors::kInvalidStateError;

- return false;

- }

- query_->AddFilter(state);

- } else if (query_json_field.key() == kLimitKey) {

- int limit = 0;

- EXTENSION_FUNCTION_VALIDATE(query_json_field.value().GetAsInteger(

- &limit));

- if (limit < 0) {

- error_ = download_extension_errors::kInvalidQueryLimit;

- return false;

- }

- query_->Limit(limit);

- } else {

- EXTENSION_FUNCTION_VALIDATE(false);

- }

- }

- return true;

-}

-

-bool DownloadsSearchFunction::ParseOrderBy(const base::Value& order_by_value) {

- static base::LazyInstance<SortTypeMap> sorter_types =

- LAZY_INSTANCE_INITIALIZER;

- if (sorter_types.Get().size() == 0)

- InitSortTypeMap(sorter_types.Get());

-

- std::string order_by_str;

- EXTENSION_FUNCTION_VALIDATE(order_by_value.GetAsString(&order_by_str));

- std::vector<std::string> order_by_strs;

- base::SplitString(order_by_str, ' ', &order_by_strs);

- for (std::vector<std::string>::const_iterator iter = order_by_strs.begin();

- iter != order_by_strs.end(); ++iter) {

- std::string term_str = *iter;

- if (term_str.empty())

- continue;

- DownloadQuery::SortDirection direction = DownloadQuery::ASCENDING;

- if (term_str[0] == '-') {

- direction = DownloadQuery::DESCENDING;

- term_str = term_str.substr(1);

- }

- SortTypeMap::const_iterator sorter_type =

- sorter_types.Get().find(term_str);

- if (sorter_type == sorter_types.Get().end()) {

- error_ = download_extension_errors::kInvalidOrderByError;

- return false;

- }

- query_->AddSorter(sorter_type->second, direction);

- }

- return true;

-}

-

-bool DownloadsSearchFunction::RunInternal() {

- DownloadManager* manager = NULL;

- DownloadManager* incognito_manager = NULL;

- GetManagers(profile(), include_incognito(), &manager, &incognito_manager);

- DownloadQuery::DownloadVector all_items, cpp_results;

- if (has_get_id_) {

- DownloadItem* item = manager->GetDownloadItem(get_id_);

- if (!item && incognito_manager)

- item = incognito_manager->GetDownloadItem(get_id_);

- if (item)

- all_items.push_back(item);

- } else {

- manager->GetAllDownloads(FilePath(FILE_PATH_LITERAL("")), &all_items);

- if (incognito_manager)

- incognito_manager->GetAllDownloads(

- FilePath(FILE_PATH_LITERAL("")), &all_items);

- }

- query_->Search(all_items.begin(), all_items.end(), &cpp_results);

- for (DownloadManager::DownloadVector::const_iterator it = cpp_results.begin();

- it != cpp_results.end(); ++it) {

-DownloadsPauseFunction::DownloadsPauseFunction()

- : SyncDownloadsFunction(DOWNLOADS_FUNCTION_PAUSE),

- download_id_(DownloadId::Invalid().local()) {

-}

-

-bool DownloadsPauseFunction::ParseArgs() {

- EXTENSION_FUNCTION_VALIDATE(args_->GetInteger(0, &download_id_));

- return true;

-}

-

-bool DownloadsPauseFunction::RunInternal() {

- DownloadItem* download_item = GetActiveItem(download_id_);

-DownloadsResumeFunction::DownloadsResumeFunction()

- : SyncDownloadsFunction(DOWNLOADS_FUNCTION_RESUME),

- download_id_(DownloadId::Invalid().local()) {

-}

-

-bool DownloadsResumeFunction::ParseArgs() {

- EXTENSION_FUNCTION_VALIDATE(args_->GetInteger(0, &download_id_));

- return true;

-}

-

-bool DownloadsResumeFunction::RunInternal() {

- DownloadItem* download_item = GetActiveItem(download_id_);

-DownloadsCancelFunction::DownloadsCancelFunction()

- : SyncDownloadsFunction(DOWNLOADS_FUNCTION_CANCEL),

- download_id_(DownloadId::Invalid().local()) {

-}

-

-bool DownloadsCancelFunction::ParseArgs() {

- EXTENSION_FUNCTION_VALIDATE(args_->GetInteger(0, &download_id_));

- return true;

-}

-

-bool DownloadsCancelFunction::RunInternal() {

- DownloadItem* download_item = GetActiveItem(download_id_);

-DownloadsEraseFunction::DownloadsEraseFunction()

- : AsyncDownloadsFunction(DOWNLOADS_FUNCTION_ERASE) {

-}

-

-bool DownloadsEraseFunction::ParseArgs() {

- base::DictionaryValue* query_json = NULL;

- EXTENSION_FUNCTION_VALIDATE(args_->GetDictionary(0, &query_json));

- return false;

-}

-

-bool DownloadsEraseFunction::RunInternal() {

- NOTIMPLEMENTED();

- return false;

-}

-

-DownloadsSetDestinationFunction::DownloadsSetDestinationFunction()

- : AsyncDownloadsFunction(DOWNLOADS_FUNCTION_SET_DESTINATION) {

-bool DownloadsSetDestinationFunction::ParseArgs() {

- int dl_id = 0;

- std::string path;

- EXTENSION_FUNCTION_VALIDATE(args_->GetInteger(0, &dl_id));

- EXTENSION_FUNCTION_VALIDATE(args_->GetString(1, &path));

- VLOG(1) << __FUNCTION__ << " " << dl_id << " " << &path;

- return false;

-}

-

-bool DownloadsSetDestinationFunction::RunInternal() {

- NOTIMPLEMENTED();

- return false;

-}

-

-DownloadsAcceptDangerFunction::DownloadsAcceptDangerFunction()

- : AsyncDownloadsFunction(DOWNLOADS_FUNCTION_ACCEPT_DANGER) {

-bool DownloadsAcceptDangerFunction::ParseArgs() {

- int dl_id = 0;

- EXTENSION_FUNCTION_VALIDATE(args_->GetInteger(0, &dl_id));

- VLOG(1) << __FUNCTION__ << " " << dl_id;

- return false;

-}

-

-bool DownloadsAcceptDangerFunction::RunInternal() {

- NOTIMPLEMENTED();

- return false;

-}

-

-DownloadsShowFunction::DownloadsShowFunction()

- : AsyncDownloadsFunction(DOWNLOADS_FUNCTION_SHOW) {

-bool DownloadsShowFunction::ParseArgs() {

- int dl_id = 0;

- EXTENSION_FUNCTION_VALIDATE(args_->GetInteger(0, &dl_id));

- VLOG(1) << __FUNCTION__ << " " << dl_id;

- return false;

-bool DownloadsShowFunction::RunInternal() {

- NOTIMPLEMENTED();

- return false;

-}

-DownloadsDragFunction::DownloadsDragFunction()

- : AsyncDownloadsFunction(DOWNLOADS_FUNCTION_DRAG) {

-bool DownloadsDragFunction::ParseArgs() {

- int dl_id = 0;

- EXTENSION_FUNCTION_VALIDATE(args_->GetInteger(0, &dl_id));

- VLOG(1) << __FUNCTION__ << " " << dl_id;

- return false;

-}

-

-bool DownloadsDragFunction::RunInternal() {

- NOTIMPLEMENTED();

- return false;

- : AsyncDownloadsFunction(DOWNLOADS_FUNCTION_GET_FILE_ICON),

- icon_size_(kDefaultIconSize),

-bool DownloadsGetFileIconFunction::ParseArgs() {

- int dl_id = 0;

- EXTENSION_FUNCTION_VALIDATE(args_->GetInteger(0, &dl_id));

-

- base::DictionaryValue* options = NULL;

- EXTENSION_FUNCTION_VALIDATE(args_->GetDictionary(1, &options));

- if (options->HasKey(kSizeKey)) {

- EXTENSION_FUNCTION_VALIDATE(options->GetInteger(kSizeKey, &icon_size_));

- // We only support 16px and 32px icons. This is enforced in

- // downloads.json.

- DCHECK(icon_size_ == 16 || icon_size_ == 32);

- }

-

- DownloadItem* download_item = manager->GetDownloadItem(dl_id);

- download_item = incognito_manager->GetDownloadItem(dl_id);

- path_ = download_item->GetTargetFilePath();

- DCHECK(!path_.empty());

- return true;

-}

-

-bool DownloadsGetFileIconFunction::RunInternal() {

- DCHECK(!path_.empty());

- path_, IconLoaderSizeFromPixelSize(icon_size_),

- if (url.empty())

- else

-class DownloadsFunctionInterface {

- public:

- enum DownloadsFunctionName {

- DOWNLOADS_FUNCTION_DOWNLOAD = 0,

- DOWNLOADS_FUNCTION_SEARCH = 1,

- DOWNLOADS_FUNCTION_PAUSE = 2,

- DOWNLOADS_FUNCTION_RESUME = 3,

- DOWNLOADS_FUNCTION_CANCEL = 4,

- DOWNLOADS_FUNCTION_ERASE = 5,

- DOWNLOADS_FUNCTION_SET_DESTINATION = 6,

- DOWNLOADS_FUNCTION_ACCEPT_DANGER = 7,

- DOWNLOADS_FUNCTION_SHOW = 8,

- DOWNLOADS_FUNCTION_DRAG = 9,

- DOWNLOADS_FUNCTION_GET_FILE_ICON = 10,

- // Insert new values here, not at the beginning.

- DOWNLOADS_FUNCTION_LAST

- };

-

- protected:

- virtual ~DownloadsFunctionInterface() {}

-

- // Return true if args_ is well-formed, otherwise set error_ and return false.

- virtual bool ParseArgs() = 0;

-

- // Implementation-specific logic. "Do the thing that you do." Should return

- // true if the call succeeded and false otherwise.

- virtual bool RunInternal() = 0;

-

- // Which subclass is this.

- virtual DownloadsFunctionName function() const = 0;

-

- // Wrap ParseArgs(), RunInternal().

- static bool RunImplImpl(DownloadsFunctionInterface* pimpl);

-};

-

-class SyncDownloadsFunction : public SyncExtensionFunction,

- public DownloadsFunctionInterface {

- protected:

- explicit SyncDownloadsFunction(DownloadsFunctionName function);

- virtual ~SyncDownloadsFunction();

-

- // ExtensionFunction:

- virtual bool RunImpl() OVERRIDE;

-

- // DownloadsFunctionInterface:

- virtual DownloadsFunctionName function() const OVERRIDE;

-

- content::DownloadItem* GetActiveItem(int download_id);

-

- private:

- DownloadsFunctionName function_;

-

- DISALLOW_COPY_AND_ASSIGN(SyncDownloadsFunction);

-};

-class AsyncDownloadsFunction : public AsyncExtensionFunction,

- public DownloadsFunctionInterface {

- protected:

- explicit AsyncDownloadsFunction(DownloadsFunctionName function);

- virtual ~AsyncDownloadsFunction();

-

- // ExtensionFunction:

- virtual bool RunImpl() OVERRIDE;

-

- // DownloadsFunctionInterface:

- virtual DownloadsFunctionName function() const OVERRIDE;

-

- content::DownloadItem* GetActiveItem(int download_id);

-

- private:

- DownloadsFunctionName function_;

-

- DISALLOW_COPY_AND_ASSIGN(AsyncDownloadsFunction);

-};

-

-class DownloadsDownloadFunction : public AsyncDownloadsFunction {

-

- // DownloadsFunctionInterface:

- virtual bool ParseArgs() OVERRIDE;

- virtual bool RunInternal() OVERRIDE;

-

- struct IOData {

- public:

- IOData();

- ~IOData();

-

- GURL url;

- string16 filename;

- bool save_as;

- base::ListValue* extra_headers;

- std::string method;

- std::string post_body;

- content::ResourceDispatcherHost* rdh;

- content::ResourceContext* resource_context;

- int render_process_host_id;

- int render_view_host_routing_id;

- };

-

- void BeginDownloadOnIOThread();

- scoped_ptr<IOData> iodata_;

-

-class DownloadsSearchFunction : public SyncDownloadsFunction {

-

- // DownloadsFunctionInterface:

- virtual bool ParseArgs() OVERRIDE;

- virtual bool RunInternal() OVERRIDE;

-

- bool ParseOrderBy(const base::Value& order_by_value);

-

- scoped_ptr<DownloadQuery> query_;

- int get_id_;

- bool has_get_id_;

-

-class DownloadsPauseFunction : public SyncDownloadsFunction {

-

- // DownloadsFunctionInterface:

- virtual bool ParseArgs() OVERRIDE;

- virtual bool RunInternal() OVERRIDE;

-

- int download_id_;

-class DownloadsResumeFunction : public SyncDownloadsFunction {

-

- // DownloadsFunctionInterface:

- virtual bool ParseArgs() OVERRIDE;

- virtual bool RunInternal() OVERRIDE;

-

- int download_id_;

-class DownloadsCancelFunction : public SyncDownloadsFunction {

-

- // DownloadsFunctionInterface:

- virtual bool ParseArgs() OVERRIDE;

- virtual bool RunInternal() OVERRIDE;

-

- int download_id_;

-class DownloadsEraseFunction : public AsyncDownloadsFunction {

-

- // DownloadsFunctionInterface:

- virtual bool ParseArgs() OVERRIDE;

- virtual bool RunInternal() OVERRIDE;

-

-class DownloadsSetDestinationFunction : public AsyncDownloadsFunction {

-

- // DownloadsFunctionInterface:

- virtual bool ParseArgs() OVERRIDE;

- virtual bool RunInternal() OVERRIDE;

-

-class DownloadsAcceptDangerFunction : public AsyncDownloadsFunction {

-

- // DownloadsFunctionInterface:

- virtual bool ParseArgs() OVERRIDE;

- virtual bool RunInternal() OVERRIDE;

-

-class DownloadsShowFunction : public AsyncDownloadsFunction {

-

- // DownloadsFunctionInterface:

- virtual bool ParseArgs() OVERRIDE;

- virtual bool RunInternal() OVERRIDE;

-

-class DownloadsDragFunction : public AsyncDownloadsFunction {

- DECLARE_EXTENSION_FUNCTION_NAME("downloads.drag");

- // DownloadsFunctionInterface:

- virtual bool ParseArgs() OVERRIDE;

- virtual bool RunInternal() OVERRIDE;

-

-class DownloadsGetFileIconFunction : public AsyncDownloadsFunction {

-

- // DownloadsFunctionInterface:

- virtual bool ParseArgs() OVERRIDE;

- virtual bool RunInternal() OVERRIDE;

-

-#include "chrome/browser/extensions/api/downloads/downloads_api.h"

- // Downloads

- RegisterFunction<DownloadsDownloadFunction>();

- RegisterFunction<DownloadsSearchFunction>();

- RegisterFunction<DownloadsPauseFunction>();

- RegisterFunction<DownloadsResumeFunction>();

- RegisterFunction<DownloadsCancelFunction>();

- RegisterFunction<DownloadsEraseFunction>();

- RegisterFunction<DownloadsSetDestinationFunction>();

- RegisterFunction<DownloadsAcceptDangerFunction>();

- RegisterFunction<DownloadsShowFunction>();

- RegisterFunction<DownloadsDragFunction>();

- RegisterFunction<DownloadsGetFileIconFunction>();

-

-[

- {

- "documentation_permissions_required": [

- "downloads"

- ],

- "events": [

- {

- "description": "This event fires with the <a href='#type-DownloadItem'>DownloadItem</a> object when a download begins.",

- "name": "onCreated",

- "parameters": [

- {

- "$ref": "DownloadItem",

- "name": "downloadItem"

- }

- ],

- "type": "function"

- },

- {

- "description": "Fires with the <code>downloadId</code> when a download is erased from history.",

- "name": "onErased",

- "parameters": [

- {

- "name": "downloadId",

- "description": "The <code>id</code> of the <a href='#type-DownloadItem'>DownloadItem</a> that was erased.",

- "type": "integer"

- }

- ],

- "type": "function"

- },

- {

- "description": "When any of a <a href='#type-DownloadItem'>DownloadItem</a>'s properties except <code>bytesReceived</code> changes, this event fires with the <code>downloadId</code> and an object containing the properties that changed.",

- "name": "onChanged",

- "parameters": [

- {

- "name": "downloadDelta",

- "properties": {

- "danger": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>danger</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "string"

- },

- "previous": {

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- },

- "dangerAccepted": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>dangerAccepted</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "boolean"

- },

- "previous": {

- "optional": true,

- "type": "boolean"

- }

- },

- "type": "object"

- },

- "endTime": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>endTime</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "integer"

- },

- "previous": {

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- },

- "error": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>error</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "integer"

- },

- "previous": {

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- },

- "fileSize": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>fileSize</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "integer"

- },

- "previous": {

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- },

- "filename": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>filename</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "string"

- },

- "previous": {

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- },

- "id": {

- "description": "The <code>id</code> of the <a href='#type-DownloadItem'>DownloadItem</a> that changed.",

- "type": "integer"

- },

- "mime": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>mime</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "string"

- },

- "previous": {

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- },

- "paused": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>paused</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "boolean"

- },

- "previous": {

- "optional": true,

- "type": "boolean"

- }

- },

- "type": "object"

- },

- "startTime": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>startTime</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "integer"

- },

- "previous": {

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- },

- "state": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>state</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "string"

- },

- "previous": {

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- },

- "totalBytes": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>totalBytes</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "integer"

- },

- "previous": {

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- },

- "url": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>url</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "string"

- },

- "previous": {

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- }

- },

- "type": "object"

- }

- ],

- "type": "function"

- }

- ],

- "functions": [

- {

- "description": "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>filename</code> and <code>saveAs</code> are specified, then the Save As dialog will be displayed, pre-populated with the specified <code>filename</code>. If the download started successfully, <code>callback</code> will be called with the new <a href='#type-DownloadItem'>DownloadItem</a>'s <code>downloadId</code>. If there was an error starting the download, then <code>callback</code> will be called with <code>downloadId=undefined</code> and <a href='extension.html#property-lastError'>chrome.extension.lastError</a> will contain a descriptive string. The error strings are not guaranteed to remain backwards compatible between releases. You must not parse it.",

- "name": "download",

- "parameters": [

- {

- "description": "What to download and how.",

- "name": "options",

- "properties": {

- "body": {

- "description": "Post body.",

- "optional": true,

- "type": "string"

- },

- "filename": {

- "description": "A file path relative to the Downloads directory to contain the downloaded file.",

- "optional": true,

- "type": "string"

- },

- "headers": {

- "description": "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>name</code> and either <code>value</code> or <code>binaryValue</code>, restricted to those allowed by XMLHttpRequest.",

- "items": {

- "properties": {

- "name": {

- "description": "Name of the HTTP header.",

- "type": "string"

- },

- "value": {

- "description": "Value of the HTTP header.",

- "type": "string"

- }

- },

- "type": "object"

- },

- "optional": true,

- "type": "array"

- },

- "method": {

- "description": "The HTTP method to use if the URL uses the HTTP[S] protocol.",

- "enum": [

- "GET",

- "POST"

- ],

- "optional": true,

- "type": "string"

- },

- "saveAs": {

- "description": "Use a file-chooser to allow the user to select a filename.",

- "optional": true,

- "type": "boolean"

- },

- "url": {

- "description": "The URL to download.",

- "type": "string"

- }

- },

- "type": "object"

- },

- {

- "name": "DownloadCallback",

- "optional": true,

- "parameters": [

- {

- "name": "downloadId",

- "type": "integer"

- }

- ],

- "type": "function"

- }

- ],

- "type": "function"

- },

- {

- "description": "Find <a href='#type-DownloadItem'>DownloadItems</a>. Set <code>query</code> to the empty object to get all <a href='#type-DownloadItem'>DownloadItems</a>. To get a specific <a href='#type-DownloadItem'>DownloadItem</a>, set only the <code>id</code> field.",

- "name": "search",

- "parameters": [

- {

- "name": "query",

- "properties": {

- "bytesReceived": {

- "description": "Number of bytes received so far from the host, without considering file compression.",

- "optional": true,

- "type": "integer"

- },

- "danger": {

- "$ref": "DangerType",

- "description": "Indication of whether this download is thought to be safe or known to be suspicious.",

- "optional": true

- },

- "dangerAccepted": {

- "description": "True if the user has accepted the download's danger.",

- "optional": true,

- "type": "boolean"

- },

- "endTime": {

- "description": "Number of milliseconds between the unix epoch and when this download ended.",

- "optional": true,

- "type": "integer"

- },

- "endedAfter": {

- "description": "Limits results to downloads that ended after the given ms since the epoch.",

- "optional": true,

- "type": "integer"

- },

- "endedBefore": {

- "description": "Limits results to downloads that ended before the given ms since the epoch.",

- "optional": true,

- "type": "integer"

- },

- "error": {

- "description": "Number indicating why a download was interrupted.",

- "optional": true,

- "type": "integer"

- },

- "fileSize": {

- "description": "Number of bytes in the whole file post-decompression, or -1 if unknown.",

- "optional": true,

- "type": "integer"

- },

- "filename": {

- "description": "Absolute local path.",

- "optional": true,

- "type": "string"

- },

- "filenameRegex": {

- "description": "Limits results to <a href='#type-DownloadItem'>DownloadItems</a> whose <code>filename</code> matches the given regular expression.",

- "optional": true,

- "type": "string"

- },

- "id": {

- "description": "An identifier that is persistent across browser sessions.",

- "optional": true,

- "type": "integer"

- },

- "limit": {

- "description": "Setting this integer limits the number of results. Otherwise, all matching <a href='#type-DownloadItem'>DownloadItems</a> will be returned.",

- "optional": true,

- "type": "integer"

- },

- "mime": {

- "description": "The file's MIME type.",

- "optional": true,

- "type": "string"

- },

- "orderBy": {

- "description": "Setting this string to a <a href='#type-DownloadItem'>DownloadItem</a> property sorts the <a href='#type-DownloadItem'>DownloadItems</a> prior to applying the above filters. For example, setting <code>orderBy='startTime'</code> sorts the <a href='#type-DownloadItem'>DownloadItems</a> by their start time in ascending order. To specify descending order, prefix <code>orderBy</code> with a hyphen: '-startTime'.",

- "optional": true,

- "type": "string"

- },

- "paused": {

- "description": "True if the download has stopped reading data from the host, but kept the connection open.",

- "optional": true,

- "type": "boolean"

- },

- "query": {

- "description": "This space-separated string of search terms that may be grouped using quotation marks limits results to <a href='#type-DownloadItem'>DownloadItems</a> whose <code>filename</code> or <code>url</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.",

- "optional": true,

- "type": "string"

- },

- "startTime": {

- "description": "Number of milliseconds between the unix epoch and when this download began.",

- "optional": true,

- "type": "integer"

- },

- "startedAfter": {

- "description": "Limits results to downloads that started after the given ms since the epoch.",

- "optional": true,

- "type": "integer"

- },

- "startedBefore": {

- "description": "Limits results to downloads that started before the given ms since the epoch.",

- "optional": true,

- "type": "integer"

- },

- "state": {

- "$ref": "State",

- "description": "Indicates whether the download is progressing, interrupted, or complete.",

- "optional": true

- },

- "totalBytes": {

- "description": "Number of bytes in the whole file, without considering file compression, or -1 if unknown.",

- "optional": true,

- "type": "integer"

- },

- "totalBytesGreater": {

- "description": "Limits results to downloads whose totalBytes is greater than the given integer.",

- "optional": true,

- "type": "integer"

- },

- "totalBytesLess": {

- "description": "Limits results to downloads whose totalBytes is less than the given integer.",

- "optional": true,

- "type": "integer"

- },

- "url": {

- "description": "Absolute URL.",

- "optional": true,

- "type": "string"

- },

- "urlRegex": {

- "description": "Limits results to <a href='#type-DownloadItem'>DownloadItems</a> whose <code>url</code> matches the given regular expression.",

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- },

- {

- "name": "SearchCallback",

- "parameters": [

- {

- "items": {

- "$ref": "DownloadItem"

- },

- "name": "results",

- "type": "array"

- }

- ],

- "type": "function"

- }

- ],

- "type": "function"

- },

- {

- "description": "Pause the download. If the request was successful the download is in a paused state. Otherwise <a href='extension.html#property-lastError'>chrome.extension.lastError</a> contains an error message. The request will fail if the download is not active.",

- "name": "pause",

- "parameters": [

- {

- "description": "The id of the download to pause.",

- "name": "downloadId",

- "type": "integer"

- },

- {

- "name": "NullCallback",

- "optional": true,

- "parameters": [],

- "type": "function"

- }

- ],

- "type": "function"

- },

- {

- "description": "Resume a paused download. If the request was successful the download is in progress and unpaused. Otherwise <a href='extension.html#property-lastError'>chrome.extension.lastError</a> contains an error message. The request will fail if the download is not active.",

- "name": "resume",

- "parameters": [

- {

- "description": "The id of the download to resume.",

- "name": "downloadId",

- "type": "integer"

- },

- {

- "name": "NullCallback",

- "optional": true,

- "parameters": [],

- "type": "function"

- }

- ],

- "type": "function"

- },

- {

- "description": "Cancel a download. When <code>callback</code> is run, the download is cancelled, completed, interrupted or doesn't exist anymore.",

- "name": "cancel",

- "parameters": [

- {

- "description": "The id of the download to cancel.",

- "name": "downloadId",

- "type": "integer"

- },

- {

- "name": "NullCallback",

- "optional": true,

- "parameters": [],

- "type": "function"

- }

- ],

- "type": "function"

- },

- {

- "description": "Retrieve an icon for the specified download. For new downloads, file icons are available after the <a href='#event-onCreated'>onCreated</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='extension.html#property-lastError'>chrome.extension.lastError</a> will contain an error message.",

- "name": "getFileIcon",

- "parameters": [

- {

- "description": "The identifier for the download.",

- "name": "downloadId",

- "type": "integer"

- },

- {

- "name": "options",

- "optional": true,

- "properties": {

- "size": {

- "description": "The size of the icon. The returned icon will be square with dimensions size * size pixels. The default size for the icon is 32x32 pixels.",

- "enum": [

- 16,

- 32

- ],

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- },

- {

- "name": "GetFileIconCallback",

- "parameters": [

- {

- "name": "iconURL",

- "optional": true,

- "type": "string"

- }

- ],

- "type": "function"

- }

- ],

- "type": "function"

- },

- {

- "description": "Erase matching <a href='#type-DownloadItem'>DownloadItems</a> from history",

- "name": "erase",

- "nodoc": true,

- "parameters": [

- {

- "$ref": "DownloadQuery",

- "name": "query"

- },

- {

- "name": "EraseCallback",

- "optional": true,

- "parameters": [

- {

- "items": {

- "type": "integer"

- },

- "name": "erasedIds",

- "type": "array"

- }

- ],

- "type": "function"

- }

- ],

- "type": "function"

- },

- {

- "description": "TODO(benjhayden) Comment.",

- "name": "setDestination",

- "nodoc": true,

- "parameters": [

- {

- "name": "downloadId",

- "type": "integer"

- },

- {

- "name": "relativePath",

- "type": "string"

- }

- ],

- "type": "function"

- },

- {

- "description": "Prompt the user to either accept or cancel a dangerous download. <code>acceptDanger()</code> does not automatically accept dangerous downloads.",

- "name": "acceptDanger",

- "nodoc": true,

- "parameters": [

- {

- "name": "downloadId",

- "type": "integer"

- }

- ],

- "type": "function"

- },

- {

- "description": "Show the downloaded file in its folder in a file manager.",

- "name": "show",

- "nodoc": true,

- "parameters": [

- {

- "name": "downloadId",

- "type": "integer"

- }

- ],

- "type": "function"

- },

- {

- "description": "Open the downloaded file.",

- "name": "open",

- "nodoc": true,

- "parameters": [

- {

- "name": "downloadId",

- "type": "integer"

- }

- ],

- "type": "function"

- },

- {

- "description": "Initiate dragging the file to another application.",

- "name": "drag",

- "nodoc": true,

- "parameters": [

- {

- "name": "downloadId",

- "type": "integer"

- }

- ],

- "type": "function"

- }

- ],

- "namespace": "downloads",

- "nodoc": false,

- "types": [

- {

- "id": "HeaderNameValuePair",

- "nodoc": true,

- "properties": {

- "name": {

- "description": "Name of the HTTP header.",

- "type": "string"

- },

- "value": {

- "description": "Value of the HTTP header.",

- "type": "string"

- }

- },

- "type": "object"

- },

- {

- "description": "",

- "enum": [

- "GET",

- "POST"

- ],

- "id": "HttpMethod",

- "nodoc": true,

- "type": "string"

- },

- {

- "id": "DownloadOptions",

- "nodoc": true,

- "properties": {

- "body": {

- "description": "Post body.",

- "optional": true,

- "type": "string"

- },

- "filename": {

- "description": "A file path relative to the Downloads directory to contain the downloaded file.",

- "optional": true,

- "type": "string"

- },

- "headers": {

- "description": "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>name</code> and either <code>value</code> or <code>binaryValue</code>, restricted to those allowed by XMLHttpRequest.",

- "items": {

- "properties": {

- "name": {

- "description": "Name of the HTTP header.",

- "type": "string"

- },

- "value": {

- "description": "Value of the HTTP header.",

- "type": "string"

- }

- },

- "type": "object"

- },

- "optional": true,

- "type": "array"

- },

- "method": {

- "description": "The HTTP method to use if the URL uses the HTTP[S] protocol.",

- "enum": [

- "GET",

- "POST"

- ],

- "optional": true,

- "type": "string"

- },

- "saveAs": {

- "description": "Use a file-chooser to allow the user to select a filename.",

- "optional": true,

- "type": "boolean"

- },

- "url": {

- "description": "The URL to download.",

- "type": "string"

- }

- },

- "type": "object"

- },

- {

- "description": "<dl><dt>file</dt><dd>The download's filename is suspicious.</dd><dt>url</dt><dd>The download's URL is known to be malicious.</dd><dt>content</dt><dd>The downloaded file is known to be malicious.</dd><dt>uncommon</dt><dd>The download's URL is not commonly downloaded and could be dangerous.</dd><dt>safe</dt><dd>The download presents no known danger to the user's computer.</dd></dl>These string constants will never change, however the set of DangerTypes may change.",

- "enum": [

- "file",

- "url",

- "content",

- "uncommon",

- "safe"

- ],

- "id": "DangerType",

- "type": "string"

- },

- {

- "description": "<dl><dt>in_progress</dt><dd>The download is currently receiving data from the server.</dd><dt>interrupted</dt><dd>An error broke the connection with the file host.</dd><dt>complete</dt><dd>The download completed successfully.</dd></dl>These string constants will never change, however the set of States may change.",

- "enum": [

- "in_progress",

- "interrupted",

- "complete"

- ],

- "id": "State",

- "type": "string"

- },

- {

- "id": "DownloadItem",

- "properties": {

- "bytesReceived": {

- "description": "Number of bytes received so far from the host, without considering file compression.",

- "name": "bytesReceived",

- "type": "integer"

- },

- "danger": {

- "$ref": "DangerType",

- "description": "Indication of whether this download is thought to be safe or known to be suspicious.",

- "name": "danger"

- },

- "dangerAccepted": {

- "description": "True if the user has accepted the download's danger.",

- "name": "dangerAccepted",

- "optional": true,

- "type": "boolean"

- },

- "endTime": {

- "description": "Number of milliseconds between the unix epoch and when this download ended.",

- "name": "endTime",

- "optional": true,

- "type": "integer"

- },

- "error": {

- "description": "Number indicating why a download was interrupted.",

- "name": "error",

- "optional": true,

- "type": "integer"

- },

- "fileSize": {

- "description": "Number of bytes in the whole file post-decompression, or -1 if unknown.",

- "name": "fileSize",

- "type": "integer"

- },

- "filename": {

- "description": "Absolute local path.",

- "name": "filename",

- "type": "string"

- },

- "id": {

- "description": "An identifier that is persistent across browser sessions.",

- "name": "id",

- "type": "integer"

- },

- "incognito": {

- "description": "False if this download is recorded in the history, true if it is not recorded.",

- "name": "incognito",

- "type": "boolean"

- },

- "mime": {

- "description": "The file's MIME type.",

- "name": "mime",

- "type": "string"

- },

- "paused": {

- "description": "True if the download has stopped reading data from the host, but kept the connection open.",

- "name": "paused",

- "type": "boolean"

- },

- "startTime": {

- "description": "Number of milliseconds between the unix epoch and when this download began.",

- "name": "startTime",

- "type": "integer"

- },

- "state": {

- "$ref": "State",

- "description": "Indicates whether the download is progressing, interrupted, or complete.",

- "name": "state"

- },

- "totalBytes": {

- "description": "Number of bytes in the whole file, without considering file compression, or -1 if unknown.",

- "name": "totalBytes",

- "type": "integer"

- },

- "url": {

- "description": "Absolute URL.",

- "name": "url",

- "type": "string"

- }

- },

- "type": "object"

- },

- {

- "id": "DownloadQuery",

- "nodoc": true,

- "properties": {

- "bytesReceived": {

- "description": "Number of bytes received so far from the host, without considering file compression.",

- "optional": true,

- "type": "integer"

- },

- "danger": {

- "$ref": "DangerType",

- "description": "Indication of whether this download is thought to be safe or known to be suspicious.",

- "optional": true

- },

- "dangerAccepted": {

- "description": "True if the user has accepted the download's danger.",

- "optional": true,

- "type": "boolean"

- },

- "endTime": {

- "description": "Number of milliseconds between the unix epoch and when this download ended.",

- "optional": true,

- "type": "integer"

- },

- "endedAfter": {

- "description": "Limits results to downloads that ended after the given ms since the epoch.",

- "optional": true,

- "type": "integer"

- },

- "endedBefore": {

- "description": "Limits results to downloads that ended before the given ms since the epoch.",

- "optional": true,

- "type": "integer"

- },

- "error": {

- "description": "Number indicating why a download was interrupted.",

- "optional": true,

- "type": "integer"

- },

- "fileSize": {

- "description": "Number of bytes in the whole file post-decompression, or -1 if unknown.",

- "optional": true,

- "type": "integer"

- },

- "filename": {

- "description": "Absolute local path.",

- "optional": true,

- "type": "string"

- },

- "filenameRegex": {

- "description": "Limits results to <a href='#type-DownloadItem'>DownloadItems</a> whose <code>filename</code> matches the given regular expression.",

- "optional": true,

- "type": "string"

- },

- "id": {

- "description": "An identifier that is persistent across browser sessions.",

- "optional": true,

- "type": "integer"

- },

- "limit": {

- "description": "Setting this integer limits the number of results. Otherwise, all matching <a href='#type-DownloadItem'>DownloadItems</a> will be returned.",

- "optional": true,

- "type": "integer"

- },

- "mime": {

- "description": "The file's MIME type.",

- "optional": true,

- "type": "string"

- },

- "orderBy": {

- "description": "Setting this string to a <a href='#type-DownloadItem'>DownloadItem</a> property sorts the <a href='#type-DownloadItem'>DownloadItems</a> prior to applying the above filters. For example, setting <code>orderBy='startTime'</code> sorts the <a href='#type-DownloadItem'>DownloadItems</a> by their start time in ascending order. To specify descending order, prefix <code>orderBy</code> with a hyphen: '-startTime'.",

- "optional": true,

- "type": "string"

- },

- "paused": {

- "description": "True if the download has stopped reading data from the host, but kept the connection open.",

- "optional": true,

- "type": "boolean"

- },

- "query": {

- "description": "This space-separated string of search terms that may be grouped using quotation marks limits results to <a href='#type-DownloadItem'>DownloadItems</a> whose <code>filename</code> or <code>url</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.",

- "optional": true,

- "type": "string"

- },

- "startTime": {

- "description": "Number of milliseconds between the unix epoch and when this download began.",

- "optional": true,

- "type": "integer"

- },

- "startedAfter": {

- "description": "Limits results to downloads that started after the given ms since the epoch.",

- "optional": true,

- "type": "integer"

- },

- "startedBefore": {

- "description": "Limits results to downloads that started before the given ms since the epoch.",

- "optional": true,

- "type": "integer"

- },

- "state": {

- "$ref": "State",

- "description": "Indicates whether the download is progressing, interrupted, or complete.",

- "optional": true

- },

- "totalBytes": {

- "description": "Number of bytes in the whole file, without considering file compression, or -1 if unknown.",

- "optional": true,

- "type": "integer"

- },

- "totalBytesGreater": {

- "description": "Limits results to downloads whose totalBytes is greater than the given integer.",

- "optional": true,

- "type": "integer"

- },

- "totalBytesLess": {

- "description": "Limits results to downloads whose totalBytes is less than the given integer.",

- "optional": true,

- "type": "integer"

- },

- "url": {

- "description": "Absolute URL.",

- "optional": true,

- "type": "string"

- },

- "urlRegex": {

- "description": "Limits results to <a href='#type-DownloadItem'>DownloadItems</a> whose <code>url</code> matches the given regular expression.",

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- },

- {

- "id": "DownloadStringDiff",

- "nodoc": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "string"

- },

- "previous": {

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- },

- {

- "id": "DownloadLongDiff",

- "nodoc": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "integer"

- },

- "previous": {

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- },

- {

- "id": "DownloadBooleanDiff",

- "nodoc": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "boolean"

- },

- "previous": {

- "optional": true,

- "type": "boolean"

- }

- },

- "type": "object"

- },

- {

- "id": "DownloadDelta",

- "nodoc": true,

- "properties": {

- "danger": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>danger</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "string"

- },

- "previous": {

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- },

- "dangerAccepted": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>dangerAccepted</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "boolean"

- },

- "previous": {

- "optional": true,

- "type": "boolean"

- }

- },

- "type": "object"

- },

- "endTime": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>endTime</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "integer"

- },

- "previous": {

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- },

- "error": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>error</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "integer"

- },

- "previous": {

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- },

- "fileSize": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>fileSize</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "integer"

- },

- "previous": {

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- },

- "filename": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>filename</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "string"

- },

- "previous": {

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- },

- "id": {

- "description": "The <code>id</code> of the <a href='#type-DownloadItem'>DownloadItem</a> that changed.",

- "type": "integer"

- },

- "mime": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>mime</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "string"

- },

- "previous": {

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- },

- "paused": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>paused</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "boolean"

- },

- "previous": {

- "optional": true,

- "type": "boolean"

- }

- },

- "type": "object"

- },

- "startTime": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>startTime</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "integer"

- },

- "previous": {

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- },

- "state": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>state</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "string"

- },

- "previous": {

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- },

- "totalBytes": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>totalBytes</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "integer"

- },

- "previous": {

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- },

- "url": {

- "description": "Describes a change in a <a href='#type-DownloadItem'>DownloadItem</a>'s <code>url</code>.",

- "optional": true,

- "properties": {

- "current": {

- "optional": true,

- "type": "string"

- },

- "previous": {

- "optional": true,

- "type": "string"

- }

- },

- "type": "object"

- }

- },

- "type": "object"

- },

- {

- "id": "GetFileIconOptions",

- "nodoc": true,

- "properties": {

- "size": {

- "description": "The size of the icon. The returned icon will be square with dimensions size * size pixels. The default size for the icon is 32x32 pixels.",

- "enum": [

- 16,

- 32

- ],

- "optional": true,

- "type": "integer"

- }

- },

- "type": "object"

- }

- ]

- }

-]

- RegisterSchema("downloads", ReadFromResource(

- IDR_EXTENSION_API_JSON_DOWNLOADS));

- types = dict((type_['id'], type_)

- for type_ in namespace_def.get('types', [])

- if type_)

- type_obj = types.get(namespace_dot + prop_ref_type,

- types.get(prop_ref_type, {}))

- if prop.get('inline_doc', False):

- del prop['inline_doc']

- SubstituteInlineDoc(prop)

- if 'items' in prop:

- SubstituteInlineDoc(prop['items'])

- <dd>Limits results to downloads that ended after the given ms since the epoch.</dd>

- <dd>Limits results to downloads that ended before the given ms since the epoch.</dd>

- <dd>An identifier that is persistent across browser sessions.</dd>

- <dd>Limits results to downloads that started after the given ms since the epoch.</dd>

- <dd>Limits results to downloads that started before the given ms since the epoch.</dd>

- <dd>Limits results to downloads whose totalBytes is greater than the given integer.</dd>

- <dd>Limits results to downloads whose totalBytes is less than the given integer.</dd>

- <dd>Describes a change in a <a href="#type-DownloadItem">DownloadItem</a>'s <code>danger</code>.</dd>

- <dd>Describes a change in a <a href="#type-DownloadItem">DownloadItem</a>'s <code>dangerAccepted</code>.</dd>

- <dd>Describes a change in a <a href="#type-DownloadItem">DownloadItem</a>'s <code>endTime</code>.</dd>

- <dd>Describes a change in a <a href="#type-DownloadItem">DownloadItem</a>'s <code>error</code>.</dd>

- <dd>Describes a change in a <a href="#type-DownloadItem">DownloadItem</a>'s <code>fileSize</code>.</dd>

- <dd>Describes a change in a <a href="#type-DownloadItem">DownloadItem</a>'s <code>filename</code>.</dd>

- <dd>The <code>id</code> of the <a href="#type-DownloadItem">DownloadItem</a> that changed.</dd>

- <dd>Describes a change in a <a href="#type-DownloadItem">DownloadItem</a>'s <code>mime</code>.</dd>

- <dd>Describes a change in a <a href="#type-DownloadItem">DownloadItem</a>'s <code>paused</code>.</dd>

- <dd>Describes a change in a <a href="#type-DownloadItem">DownloadItem</a>'s <code>startTime</code>.</dd>

- <dd>Describes a change in a <a href="#type-DownloadItem">DownloadItem</a>'s <code>state</code>.</dd>

- <dd>Describes a change in a <a href="#type-DownloadItem">DownloadItem</a>'s <code>totalBytes</code>.</dd>

- <dd>Describes a change in a <a href="#type-DownloadItem">DownloadItem</a>'s <code>url</code>.</dd>

- <dd><dl><dt>file</dt><dd>The download's filename is suspicious.</dd><dt>url</dt><dd>The download's URL is known to be malicious.</dd><dt>content</dt><dd>The downloaded file is known to be malicious.</dd><dt>uncommon</dt><dd>The download's URL is not commonly downloaded and could be dangerous.</dd><dt>safe</dt><dd>The download presents no known danger to the user's computer.</dd></dl>These string constants will never change, however the set of DangerTypes may change.</dd>

- <dd><dl><dt>in_progress</dt><dd>The download is currently receiving data from the server.</dd><dt>interrupted</dt><dd>An error broke the connection with the file host.</dd><dt>complete</dt><dd>The download completed successfully.</dd></dl>These string constants will never change, however the set of States may change.</dd>

- "chrome.experimental.dns.resolve": "experimental.dns.html#method-resolve",

- "chrome.experimental.idltest.getArrayBuffer": "experimental.idltest.html#method-getArrayBuffer",

- "chrome.experimental.idltest.nocompileFunc": "experimental.idltest.html#method-nocompileFunc",

- "chrome.experimental.idltest.sendArrayBuffer": "experimental.idltest.html#method-sendArrayBuffer",

- "chrome.experimental.idltest.sendArrayBufferView": "experimental.idltest.html#method-sendArrayBufferView",

- <include name="IDR_EXTENSION_API_JSON_DOWNLOADS" file="extensions\api\downloads.json" type="BINDATA" />

-# A dictionary contains is a named list of optional and required members.

- p[0] = self.BuildNamed('Dictionary', p, 3, ListFromConcat(p[5]))

- children = ListFromConcat(p[1],p[2], typeref, p[4])

- .Append('using base::Value;')

- .Append('using base::DictionaryValue;')

- .Append('using base::ListValue;')

- .Append('using base::BinaryValue;')

- .Append('using %s;' % any_helper.ANY_CLASS)

- .Append()

- '(const Value& value, %(name)s* out) {')

- .Append('if (!value.IsType(Value::TYPE_DICTIONARY))')

- (c.Append('const DictionaryValue* dict = '

- 'static_cast<const DictionaryValue*>(&value);')

- src: DictionaryValue*

- c.Append('Value* %(value_var)s = NULL;')

- """Generates a function that serializes the type into a |DictionaryValue|.

- (c.Sblock('scoped_ptr<DictionaryValue> %s::ToValue() const {' %

- .Append('scoped_ptr<DictionaryValue> value(new DictionaryValue());')

- """Generates CreateEnumValue() that returns the |StringValue|

- c.Sblock('scoped_ptr<Value> %(cpp_namespace)s::CreateEnumValue(%(arg)s) {')

- .Append(' return scoped_ptr<Value>();')

- .Append(' return scoped_ptr<Value>(Value::CreateStringValue("%s"));' %

- enum_value)

- .Append(' return scoped_ptr<Value>();')

- """Creates a Value given a property. Generated code passes ownership

- E.g for std::string, generate Value::CreateStringValue(var)

- # generate a function that returns a scoped_ptr<Value> and put it in

- 'Conversion of CHOICES to Value not implemented')

- PropertyType.STRING: 'Value::CreateStringValue(%s)',

- PropertyType.BOOLEAN: 'Value::CreateBooleanValue(%s)',

- PropertyType.INTEGER: 'Value::CreateIntegerValue(%s)',

- PropertyType.DOUBLE: 'Value::CreateDoubleValue(%s)',

- raise NotImplementedError('Conversion of %s to Value not '

- function takes a ListValue of arguments.

- '%(cpp_namespace)s::Params::Create(const ListValue& args) {')

- (c.Append('Value* %(value_var)s = NULL;')

- .Append('if (args.Get(%(i)s, &%(value_var)s) && '

- '!%(value_var)s->IsType(Value::TYPE_NULL))')

- """Generates code to populate a model.Property given a Value*. The

- existence of data inside the Value* is assumed so checks for existence

- value_var: a Value* that should represent |prop|.

- check_type: if true, will check if |value_var| is the correct Value::Type

- (c.Append('DictionaryValue* dictionary = NULL;')

- (c.Append('DictionaryValue* dictionary = NULL;')

- c.Append('%(dst)s->%(name)s.reset(new Any());')

- (c.Append('ListValue* list = NULL;')

- # to the BinaryValue to be able to populate it, so a scoped_ptr is used

- # whether it is optional or required.

- .Append(' static_cast<BinaryValue*>(%(value_var)s)->DeepCopy());')

- (c.Append('Value* %s::Result::Create() {' % cpp_namespace)

- .Append(' return Value::CreateNullValue();')

- # Generation of Value* Create(Value*) is redundant.

- c.Sblock('Value* %(cpp_namespace)s::Result::Create(const %(arg)s) {')

-import string

- c.Substitute({'name': type_name, 'item_type':

- self.GetType(namespace.types[type_].item_type,

- wrap_optional=True)})

- tabs_namespace = m.AddNamespace(self.tabs_json[0],

- 'path/to/tabs.json')

- browser_action_namespace = m.AddNamespace(self.browser_action_json[0],

- 'path/to/browser_action.json')

- manager.AddNamespace(browser_action_namespace,

- self.browser_action.unix_name)

-import model

-import os

- if not prop.optional and prop.type_ == PropertyType.REF:

- c.Substitute({'classname': classname})

- (c.Comment('Populates a %s object from a Value. Returns'

- .Append(

- 'static bool Populate(const Value& value, %(classname)s* out);')

- (c.Comment('Returns a new DictionaryValue representing the'

- .Append('scoped_ptr<DictionaryValue> ToValue() const;')

- .Append('static scoped_ptr<Params> Create(const ListValue& args);')

- c.Append('static scoped_ptr<Value> CreateEnumValue(%s %s);' %

- c.Append('Value* Create();')

- c.Comment("Value* Result::Create(Value*) not generated "

- c.Append('Value* Create(const %s);' % cpp_util.GetParameterDeclaration(

- param, self._cpp_type_generator.GetType(param)))

- # Find all the parameter comments of the form "|name|: comment".

- return Typeref(self.node.GetProperty( 'TYPEREF'),

- { 'name': self.node.GetName() }).process(callbacks)

- return { 'id': self.node.GetName(),

- 'properties': properties,

- 'type': 'object' }

-

-class Enum(object):

- '''

- Given an IDL Enum node, converts into a Python dictionary that the JSON

- schema compiler expects to see.

- '''

- def __init__(self, enum_node):

- self.node = enum_node

-

- def process(self, callbacks):

- enum = []

- for node in self.node.children:

- if node.cls == 'EnumItem':

- name = node.GetName()

- enum.append(name)

- else:

- sys.exit("Did not process %s %s" % (node.cls, node))

- return { "id" : self.node.GetName(),

- 'enum': enum,

- 'type': 'string' }

-

- for node in self.node.children:

- if node.cls == 'Callspec':

- def __init__(self, namespace_node, nodoc=False):

- cls = node.cls

- if cls == "Dictionary":

- elif cls == "Callback":

- elif cls == "Interface" and node.GetName() == "Functions":

- elif cls == "Interface" and node.GetName() == "Events":

- elif cls == "Enum":

- sys.exit("Did not process %s %s" % (node.cls, node))

-

- return { 'events': self.events,

- 'functions': self.functions,

- 'types': self.types,

- 'namespace': self.namespace.GetName(),

- 'nodoc': self.nodoc }

- nodoc = False

- cls = node.cls

- if cls == 'Namespace':

- namespace = Namespace(node, nodoc)

- elif cls == 'Copyright':

- elif cls == 'Comment':

- elif cls == 'ExtAttribute':

- sys.exit("Did not process %s %s" % (node.cls, node))

- expected = {'enum': ['name1', 'name2'],

- self.assertEquals(expected, getType(schema, 'idl_basics.EnumType'))

- elif 'enum' in json:

- long x; // This comment tests "double-quotes".