chrome.downloads

설명

chrome.downloads API를 사용하여 다운로드를 프로그래매틱 방식으로 시작, 모니터링, 조작, 검색합니다.

권한

downloads

이 API를 사용하려면 확장 프로그램 매니페스트에서 "downloads" 권한을 선언해야 합니다.

{
  "name": "My extension",
  ...
  "permissions": [
    "downloads"
  ],
}

예

chrome.downloads API 사용의 간단한 예는 examples/api/downloads 디렉터리에서 확인할 수 있습니다. 다른 예시와 소스 코드 보기 도움말은 샘플을 참고하세요.

유형

BooleanDelta

속성

  • 현재

    불리언 선택사항

  • 이전

    불리언 선택사항

DangerType

파일

다운로드 파일 이름이 의심스럽습니다.

URL

다운로드의 URL이 악성인 것으로 알려져 있습니다.

콘텐츠

다운로드한 파일이 악성 파일인 것으로 알려져 있습니다.

흔치 않음

다운로드의 URL은 일반적으로 다운로드되지 않으며 위험할 수 있습니다.

호스트

다운로드가 악성 바이너리를 배포하는 것으로 알려진 호스트에서 제공되었으며 위험할 수 있습니다.

원치 않는

다운로드가 원치 않거나 안전하지 않을 수 있습니다. 예를 들어 브라우저 또는 컴퓨터 설정을 변경할 수 있습니다.

안전

다운로드로 인해 사용자의 컴퓨터에 알려진 위험이 발생하지 않습니다.

수락됨

사용자가 위험한 다운로드를 수락했습니다.

열거형

'file'

"url"

"content"

'uncommon'

'host'

"unwanted"

'safe'

'accepted'

"allowlistedByPolicy"

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

'deepScannedSafe'

"deepScannedOpenedDangerous"

"promptForScanning"

"promptForLocalPasswordScanning"

'accountCompromise'

'blockedScanFailed'

DoubleDelta

속성

  • 현재

    번호 선택사항

  • 이전

    번호 선택사항

DownloadDelta

속성

  • canResume

    BooleanDelta 선택사항

    canResume의 변경사항(있는 경우)

  • 위험

    StringDelta 선택사항

    danger의 변경사항(있는 경우)

  • endTime

    StringDelta 선택사항

    endTime의 변경사항(있는 경우)

  • 오류

    StringDelta 선택사항

    error의 변경사항(있는 경우)

  • 존재함

    BooleanDelta 선택사항

    exists의 변경사항(있는 경우)

  • fileSize

    DoubleDelta 선택사항

    fileSize의 변경사항(있는 경우)

  • filename

    StringDelta 선택사항

    filename의 변경사항(있는 경우)

  • finalUrl

    StringDelta 선택사항

    Chrome 54 이상

    finalUrl의 변경사항(있는 경우)

  • id

    숫자

    변경된 DownloadItem의 id입니다.

  • 마임

    StringDelta 선택사항

    mime의 변경사항(있는 경우)

  • 일시중지됨

    BooleanDelta 선택사항

    paused의 변경사항(있는 경우)

  • startTime

    StringDelta 선택사항

    startTime의 변경사항(있는 경우)

  • 주

    StringDelta 선택사항

    state의 변경사항(있는 경우)

  • totalBytes

    DoubleDelta 선택사항

    totalBytes의 변경사항(있는 경우)

  • URL

    StringDelta 선택사항

    url의 변경사항(있는 경우)

DownloadItem

속성

  • byExtensionId

    문자열 선택사항

    이 다운로드가 확장 프로그램에 의해 시작된 경우 이 다운로드를 시작한 확장 프로그램의 식별자입니다. 설정된 후에는 변경되지 않습니다.

  • byExtensionName

    문자열 선택사항

    이 다운로드가 확장 프로그램에 의해 시작된 경우 이 다운로드를 시작한 확장 프로그램의 현지화된 이름입니다. 확장 프로그램이 이름을 변경하거나 사용자가 언어를 변경하면 변경될 수 있습니다.

  • bytesReceived

    숫자

    파일 압축을 고려하지 않고 호스트로부터 지금까지 수신된 바이트 수입니다.

  • canResume

    부울

    다운로드가 진행 중이고 일시중지된 경우 또는 다운로드가 중단되었으며 중단된 위치부터 재개할 수 있는 경우 true입니다.

  • 위험

    DangerType

    이 다운로드가 안전한 것으로 생각되는지 또는 의심스러운 것으로 알려져 있는지 나타냅니다.

  • endTime

    문자열 선택사항

    다운로드가 종료된 시간입니다(ISO 8601 형식). Date 생성자에 직접 전달할 수 있습니다. chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})

  • 오류

    InterruptReason 선택사항

    다운로드가 중단된 이유입니다. 여러 종류의 HTTP 오류가 SERVER_로 시작하는 오류 중 하나로 그룹화될 수 있습니다. 네트워크 관련 오류는 NETWORK_로 시작하고, 파일 시스템에 파일을 쓰는 프로세스와 관련된 오류는 FILE_로 시작하며, 사용자가 시작한 인터럽트는 USER_로 시작합니다.

  • estimatedEndTime

    문자열 선택사항

    다운로드가 완료될 것으로 예상되는 시간입니다(ISO 8601 형식). Date 생성자에 직접 전달할 수 있습니다. chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})

  • 존재함

    부울

    다운로드된 파일이 아직 있는지 여부입니다. Chrome에서는 파일 삭제를 자동으로 감시하지 않으므로 이 정보가 오래되었을 수 있습니다. 파일 존재 여부 확인을 트리거하려면 search()를 호출합니다. 존재 확인이 완료되면 파일이 삭제된 경우 onChanged 이벤트가 실행됩니다. search()는 존재 확인이 완료될 때까지 기다리지 않고 반환되므로 search()의 결과가 파일 시스템을 정확하게 반영하지 않을 수 있습니다. 또한 search()는 필요한 만큼 자주 호출될 수 있지만 10초에 한 번 이상 파일 존재를 확인하지는 않습니다.

  • fileSize

    숫자

    전체 파일의 압축 해제 후 바이트 수입니다. 알 수 없는 경우 -1입니다.

  • filename

    문자열

    절대 로컬 경로입니다.

  • finalUrl

    문자열

    Chrome 54 이상

    모든 리디렉션 후 이 다운로드가 이루어지는 절대 URL입니다.

  • id

    숫자

    브라우저 세션 간에 지속되는 식별자입니다.

  • 시크릿 모드

    부울

    이 다운로드가 기록에 기록되면 false이고 기록되지 않으면 true입니다.

  • 마임

    문자열

    파일의 MIME 유형입니다.

  • 일시중지됨

    부울

    다운로드에서 호스트로부터 데이터 읽기를 중지했지만 연결을 열린 상태로 유지한 경우 true입니다.

  • 리퍼러

    문자열

    절대 URL입니다.

  • startTime

    문자열

    다운로드가 시작된 시간입니다(ISO 8601 형식). Date 생성자에 직접 전달할 수 있습니다. chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})

  • 주

    상태

    다운로드가 진행 중인지, 중단되었는지, 완료되었는지를 나타냅니다.

  • totalBytes

    숫자

    파일 압축을 고려하지 않은 전체 파일의 바이트 수입니다. 알 수 없는 경우 -1입니다.

  • URL

    문자열

    리디렉션 전 이 다운로드가 시작된 절대 URL입니다.

DownloadOptions

속성

  • 본문

    문자열 선택사항

    게시물 본문입니다.

  • conflictAction

    FilenameConflictAction 선택사항

    filename이 이미 있는 경우 수행할 작업입니다.

  • filename

    문자열 선택사항

    다운로드한 파일을 포함할 다운로드 디렉터리를 기준으로 하는 파일 경로입니다. 하위 디렉터리가 포함될 수 있습니다. 절대 경로, 빈 경로, 역참조 '..'가 포함된 경로는 오류를 일으킵니다. onDeterminingFilename를 사용하면 파일의 MIME 유형과 임시 파일 이름이 결정된 후 파일 이름을 제안할 수 있습니다.

  • 헤더

    HeaderNameValuePair[] 선택사항

    URL이 HTTP[s] 프로토콜을 사용하는 경우 요청과 함께 전송할 추가 HTTP 헤더입니다. 각 헤더는 키 name와 value 또는 binaryValue를 포함하는 사전으로 표현되며, XMLHttpRequest에서 허용되는 헤더로 제한됩니다.

  • method

    HttpMethod 선택사항

    URL이 HTTP[S] 프로토콜을 사용하는 경우 사용할 HTTP 메서드입니다.

  • saveAs

    불리언 선택사항

    파일 선택 도구를 사용하여 filename가 설정되었는지 또는 이미 존재하는지 여부와 관계없이 사용자가 파일 이름을 선택할 수 있도록 합니다.

  • URL

    문자열

    다운로드할 URL입니다.

DownloadQuery

속성

  • bytesReceived

    번호 선택사항

    파일 압축을 고려하지 않고 호스트로부터 지금까지 수신된 바이트 수입니다.

  • 위험

    DangerType 선택사항

    이 다운로드가 안전한 것으로 생각되는지 또는 의심스러운 것으로 알려져 있는지 나타냅니다.

  • endTime

    문자열 선택사항

    다운로드가 종료된 시간입니다(ISO 8601 형식).

  • endedAfter

    문자열 선택사항

    결과를 ISO 8601 형식으로 지정된 ms 이후에 종료된 DownloadItem로 제한합니다.

  • endedBefore

    문자열 선택사항

    결과를 ISO 8601 형식으로 지정된 ms 전에 종료된 DownloadItem로 제한합니다.

  • 오류

    InterruptReason 선택사항

    다운로드가 중단된 이유입니다.

  • 존재함

    불리언 선택사항

    다운로드된 파일이 있는지 여부

  • fileSize

    번호 선택사항

    전체 파일의 압축 해제 후 바이트 수입니다. 알 수 없는 경우 -1입니다.

  • filename

    문자열 선택사항

    절대 로컬 경로입니다.

  • filenameRegex

    문자열 선택사항

    filename이 지정된 정규 표현식과 일치하는 DownloadItem로 결과를 제한합니다.

  • finalUrl

    문자열 선택사항

    Chrome 54 이상

    모든 리디렉션 후 이 다운로드가 이루어지는 절대 URL입니다.

  • finalUrlRegex

    문자열 선택사항

    Chrome 54 이상

    finalUrl이 지정된 정규 표현식과 일치하는 DownloadItem로 결과를 제한합니다.

  • id

    번호 선택사항

    쿼리할 DownloadItem의 id입니다.

  • 제한

    번호 선택사항

    반환되는 일치하는 DownloadItem의 최대 개수입니다. 기본값은 1000입니다. 일치하는 모든 DownloadItem을 반환하려면 0으로 설정합니다. 결과를 페이지로 나누는 방법은 search를 참고하세요.

  • 마임

    문자열 선택사항

    파일의 MIME 유형입니다.

  • orderBy

    string[] 선택사항

    검색 결과를 정렬하려면 이 배열의 요소를 DownloadItem 속성으로 설정하세요. 예를 들어 orderBy=['startTime']를 설정하면 시작 시간에 따라 DownloadItem가 오름차순으로 정렬됩니다. 내림차순을 지정하려면 '-startTime'과 같이 하이픈을 앞에 붙입니다.

  • 일시중지됨

    불리언 선택사항

    다운로드에서 호스트로부터 데이터 읽기를 중지했지만 연결을 열린 상태로 유지한 경우 true입니다.

  • query

    string[] 선택사항

    이 검색어 배열은 filename 또는 url 또는 finalUrl에 대시 '-'로 시작하지 않는 모든 검색어가 포함되고 대시로 시작하는 검색어는 포함되지 않는 DownloadItem로 결과를 제한합니다.

  • startTime

    문자열 선택사항

    다운로드가 시작된 시간입니다(ISO 8601 형식).

  • startedAfter

    문자열 선택사항

    결과를 ISO 8601 형식으로 지정된 ms 이후에 시작된 DownloadItem로 제한합니다.

  • startedBefore

    문자열 선택사항

    결과를 ISO 8601 형식으로 지정된 ms 전에 시작된 DownloadItem로 제한합니다.

  • 주

    주 선택사항

    다운로드가 진행 중인지, 중단되었는지, 완료되었는지를 나타냅니다.

  • totalBytes

    번호 선택사항

    파일 압축을 고려하지 않은 전체 파일의 바이트 수입니다. 알 수 없는 경우 -1입니다.

  • totalBytesGreater

    번호 선택사항

    totalBytes이 지정된 정수보다 큰 DownloadItem로 결과를 제한합니다.

  • totalBytesLess

    번호 선택사항

    totalBytes이 지정된 정수보다 작은 DownloadItem로 결과를 제한합니다.

  • URL

    문자열 선택사항

    리디렉션 전 이 다운로드가 시작된 절대 URL입니다.

  • urlRegex

    문자열 선택사항

    url이 지정된 정규 표현식과 일치하는 DownloadItem로 결과를 제한합니다.

FilenameConflictAction

uniquify

중복을 방지하기 위해 filename가 파일 이름 확장자 앞에 카운터를 포함하도록 변경됩니다.

덮어쓰기

기존 파일이 새 파일로 덮어쓰여집니다.

프롬프트

사용자에게 파일 선택기 대화상자가 표시됩니다.

열거형

'uniquify'

'overwrite'

'prompt'

FilenameSuggestion

속성

  • conflictAction

    FilenameConflictAction 선택사항

    filename이 이미 있는 경우 수행할 작업입니다.

  • filename

    문자열

    사용자의 기본 다운로드 디렉터리를 기준으로 하는 경로로서, 하위 디렉터리가 포함될 수 있는 DownloadItem의 새 타겟 DownloadItem.filename입니다. 절대 경로, 빈 경로, 역참조 '..'가 포함된 경로는 무시됩니다. 확장에서 등록한 onDeterminingFilename 리스너가 있으면 filename은 무시됩니다.

GetFileIconOptions

속성

  • 크기

    번호 선택사항

    반환된 아이콘의 크기입니다. 아이콘은 크기 * 크기 픽셀의 정사각형입니다. 아이콘의 기본 크기이자 최대 크기는 32x32픽셀입니다. 지원되는 크기는 16과 32뿐입니다. 다른 크기를 지정하면 오류가 발생합니다.

HeaderNameValuePair

속성

  • 이름

    문자열

    HTTP 헤더의 이름입니다.

  • 값

    문자열

    HTTP 헤더의 값입니다.

HttpMethod

열거형

'GET'

"POST"

InterruptReason

열거형

"FILE_FAILED"

'FILE_ACCESS_DENIED'

'FILE_NO_SPACE'

"FILE_NAME_TOO_LONG"

"FILE_TOO_LARGE"

"FILE_VIRUS_INFECTED"

'FILE_TRANSIENT_ERROR'

'FILE_BLOCKED'

"FILE_SECURITY_CHECK_FAILED"

'FILE_TOO_SHORT'

"FILE_HASH_MISMATCH"

"FILE_SAME_AS_SOURCE"

"NETWORK_FAILED"

"NETWORK_TIMEOUT"

"NETWORK_DISCONNECTED"

"NETWORK_SERVER_DOWN"

"NETWORK_INVALID_REQUEST"

"SERVER_FAILED"

"SERVER_NO_RANGE"

'SERVER_BAD_CONTENT'

"SERVER_UNAUTHORIZED"

'SERVER_CERT_PROBLEM'

'SERVER_FORBIDDEN'

'SERVER_UNREACHABLE'

"SERVER_CONTENT_LENGTH_MISMATCH"

"SERVER_CROSS_ORIGIN_REDIRECT"

"USER_CANCELED"

"USER_SHUTDOWN"

'CRASH'

State

in_progress

현재 다운로드에서 서버로부터 데이터를 수신하고 있습니다.

중단됨

오류로 인해 파일 호스트와의 연결이 끊어졌습니다.

완료

다운로드가 완료되었습니다.

열거형

"in_progress"

"interrupted"

'complete'

StringDelta

속성

  • 현재

    문자열 선택사항

  • 이전

    문자열 선택사항

UiOptions

Chrome 105 이상

속성

  • 사용 설정됨

    부울

    다운로드 UI를 사용 설정하거나 사용 중지합니다.

메서드

acceptDanger()

chrome.downloads.acceptDanger(
  downloadId: number,
): Promise<void>

사용자에게 위험한 다운로드를 수락하라는 메시지를 표시합니다. 표시되는 컨텍스트 (탭, 창 또는 페이지/브라우저 작업 팝업)에서만 호출할 수 있습니다. 위험한 다운로드를 자동으로 수락하지 않습니다. 다운로드가 수락되면 onChanged 이벤트가 발생하고, 그렇지 않으면 아무 일도 일어나지 않습니다. 모든 데이터가 임시 파일로 가져오고 다운로드가 위험하지 않거나 위험이 수락되면 임시 파일 이름이 타겟 파일 이름으로 변경되고 state가 'complete'로 변경되며 onChanged가 실행됩니다.

매개변수

반환 값

  • Promise<void>

    Chrome 96 이상

cancel()

chrome.downloads.cancel(
  downloadId: number,
): Promise<void>

다운로드 취소 callback가 실행되면 다운로드가 취소되거나, 완료되거나, 중단되거나, 더 이상 존재하지 않습니다.

매개변수

  • downloadId

    숫자

    취소할 다운로드의 ID입니다.

반환 값

  • Promise<void>

    Chrome 96 이상

download()

chrome.downloads.download(
  options: DownloadOptions,
): Promise<number>

URL을 다운로드합니다. URL이 HTTP[S] 프로토콜을 사용하는 경우 요청에는 현재 호스트 이름에 설정된 모든 쿠키가 포함됩니다. filename 및 saveAs가 모두 지정된 경우 지정된 filename로 미리 채워진 다른 이름으로 저장 대화상자가 표시됩니다. 다운로드가 성공적으로 시작되면 새 DownloadItem의 downloadId로 callback가 호출됩니다. 다운로드를 시작하는 중에 오류가 발생한 경우 callback가 downloadId=undefined와 함께 호출되고 runtime.lastError에는 설명 문자열이 포함됩니다. 오류 문자열은 출시 간에 이전 버전과의 호환성이 유지되지 않을 수 있습니다. 확장 프로그램은 이를 파싱해서는 안 됩니다.

매개변수

반환 값

  • Promise<number>

    Chrome 96 이상

erase()

chrome.downloads.erase(
  query: DownloadQuery,
): Promise<number[]>

다운로드한 파일을 삭제하지 않고 기록에서 일치하는 DownloadItem를 삭제합니다. query와 일치하는 각 DownloadItem에 대해 onErased 이벤트가 발생한 다음 callback이 호출됩니다.

매개변수

반환 값

  • Promise<number[]>

    Chrome 96 이상

getFileIcon()

chrome.downloads.getFileIcon(
  downloadId: number,
  options?: GetFileIconOptions,
): Promise<string | undefined>

지정된 다운로드의 아이콘을 가져옵니다. 새 다운로드의 경우 onCreated 이벤트가 수신된 후에 파일 아이콘을 사용할 수 있습니다. 다운로드가 진행 중일 때 이 함수에서 반환된 이미지는 다운로드가 완료된 후 반환된 이미지와 다를 수 있습니다. 아이콘 가져오기는 플랫폼에 따라 기본 운영체제 또는 툴킷을 쿼리하여 실행됩니다. 따라서 반환되는 아이콘은 다운로드 상태, 플랫폼, 등록된 파일 유형, 시각적 테마 등 여러 요소에 따라 달라집니다. 파일 아이콘을 확인할 수 없는 경우 runtime.lastError에 오류 메시지가 포함됩니다.

매개변수

  • downloadId

    숫자

    다운로드의 식별자입니다.

  • 옵션

    GetFileIconOptions 선택사항

반환 값

  • Promise<string | undefined>

    Chrome 96 이상

open()

chrome.downloads.open(
  downloadId: number,
): Promise<void>

DownloadItem가 완료되면 다운로드된 파일을 지금 열고, 그렇지 않으면 runtime.lastError를 통해 오류를 반환합니다. 이 메서드를 사용하려면 "downloads" 권한 외에 "downloads.open" 권한도 필요합니다. 상품을 처음 열면 onChanged 이벤트가 발생합니다. 이 메서드는 사용자 동작에 대한 응답으로만 호출할 수 있습니다.

매개변수

  • downloadId

    숫자

    다운로드된 파일의 식별자입니다.

반환 값

  • Promise<void>

    Chrome 123 이상

pause()

chrome.downloads.pause(
  downloadId: number,
): Promise<void>

다운로드를 일시중지합니다. 요청이 성공하면 다운로드가 일시중지된 상태입니다. 그렇지 않으면 runtime.lastError에 오류 메시지가 포함됩니다. 다운로드가 활성 상태가 아니면 요청이 실패합니다.

매개변수

  • downloadId

    숫자

    일시중지할 다운로드의 ID입니다.

반환 값

  • Promise<void>

    Chrome 96 이상

removeFile()

chrome.downloads.removeFile(
  downloadId: number,
): Promise<void>

다운로드된 파일이 있고 DownloadItem가 완료된 경우 다운로드된 파일을 삭제합니다. 그렇지 않으면 runtime.lastError를 통해 오류를 반환합니다.

매개변수

  • downloadId

    숫자

반환 값

  • Promise<void>

    Chrome 96 이상

resume()

chrome.downloads.resume(
  downloadId: number,
): Promise<void>

일시중지된 다운로드를 재개합니다. 요청이 성공하면 다운로드가 진행 중이며 일시중지되지 않습니다. 그렇지 않으면 runtime.lastError에 오류 메시지가 포함됩니다. 다운로드가 활성 상태가 아니면 요청이 실패합니다.

매개변수

  • downloadId

    숫자

    재개할 다운로드의 ID입니다.

반환 값

  • Promise<void>

    Chrome 96 이상 
chrome.downloads.search(
  query: DownloadQuery,
): Promise<DownloadItem[]>

DownloadItem를 찾습니다. 모든 DownloadItem을 가져오려면 query을 빈 객체로 설정합니다. 특정 DownloadItem를 가져오려면 id 필드만 설정합니다. 많은 수의 항목을 페이지로 나누려면 orderBy: ['-startTime']를 설정하고, limit을 페이지당 항목 수로 설정하고, startedAfter을 마지막 페이지의 마지막 항목의 startTime로 설정합니다.

매개변수

반환 값

setShelfEnabled()

Chrome 117부터 지원 중단됨
chrome.downloads.setShelfEnabled(
  enabled: boolean,
): void

대신 setUiOptions를 사용하세요.

현재 브라우저 프로필과 연결된 모든 창 하단의 회색 선반을 사용 설정 또는 사용 중지합니다. 하나 이상의 확장 프로그램에서 사용 중지한 경우 선반이 사용 중지됩니다. 다른 확장 프로그램이 하나 이상 사용 중지된 상태에서 선반을 사용 설정하면 runtime.lastError를 통해 오류가 반환됩니다. "downloads" 권한 외에 "downloads.shelf" 권한이 필요합니다.

매개변수

  • 사용 설정됨

    부울

setUiOptions()

Chrome 105 이상 
chrome.downloads.setUiOptions(
  options: UiOptions,
): Promise<void>

현재 브라우저 프로필과 연결된 모든 창의 다운로드 UI를 변경합니다. 하나 이상의 확장 프로그램에서 UiOptions.enabled을 false로 설정한 경우 다운로드 UI가 숨겨집니다. 다른 확장 프로그램이 하나 이상 사용 중지된 상태에서 UiOptions.enabled을 true로 설정하면 runtime.lastError을 통해 오류가 반환됩니다. "downloads" 권한 외에 "downloads.ui" 권한이 필요합니다.

매개변수

  • 옵션

    UiOptions

    다운로드 UI 변경사항을 캡슐화합니다.

반환 값

  • Promise<void>

show()

chrome.downloads.show(
  downloadId: number,
): void

파일 관리자에서 다운로드한 파일을 폴더에 표시합니다.

매개변수

  • downloadId

    숫자

    다운로드된 파일의 식별자입니다.

showDefaultFolder()

chrome.downloads.showDefaultFolder(): void

파일 관리자에 기본 다운로드 폴더를 표시합니다.

이벤트

onChanged

chrome.downloads.onChanged.addListener(
  callback: function,
)

bytesReceived 및 estimatedEndTime을 제외한 DownloadItem의 속성이 변경되면 이 이벤트는 downloadId 및 변경된 속성이 포함된 객체와 함께 발생합니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (downloadDelta: DownloadDelta) => void

onCreated

chrome.downloads.onCreated.addListener(
  callback: function,
)

이 이벤트는 다운로드가 시작될 때 DownloadItem 객체와 함께 발생합니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (downloadItem: DownloadItem) => void

onDeterminingFilename

chrome.downloads.onDeterminingFilename.addListener(
  callback: function,
)

파일 이름 결정 프로세스 중에 확장 프로그램은 타겟 DownloadItem.filename을 재정의할 수 있습니다. 각 확장 프로그램은 이 이벤트에 대해 두 개 이상의 리스너를 등록할 수 없습니다. 각 리스너는 동기식 또는 비동기식으로 suggest를 정확히 한 번 호출해야 합니다. 리스너가 비동기적으로 suggest를 호출하면 true을 반환해야 합니다. 리스너가 동기식으로 suggest를 호출하지도 않고 true를 반환하지도 않으면 suggest가 자동으로 호출됩니다. 모든 리스너가 suggest를 호출할 때까지 DownloadItem가 완료되지 않습니다. 리스너는 다운로드에서 파일 이름에 downloadItem.filename을 사용할 수 있도록 인수 없이 suggest을 호출하거나 suggestion 객체를 suggest에 전달하여 타겟 파일 이름을 재정의할 수 있습니다. 두 개 이상의 확장 프로그램이 파일 이름을 재정의하는 경우 리스너가 suggestion 객체를 suggest에 전달하는 마지막으로 설치된 확장 프로그램이 우선합니다. 어떤 확장 프로그램이 우선하는지 혼동하지 않도록 사용자는 충돌할 수 있는 확장 프로그램을 설치해서는 안 됩니다. 다운로드가 download에 의해 시작되고 MIME 유형과 임시 파일 이름이 결정되기 전에 타겟 파일 이름을 알고 있는 경우 filename을 download에 전달하세요.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (downloadItem: DownloadItem, suggest: function) => void

onErased

chrome.downloads.onErased.addListener(
  callback: function,
)

다운로드가 기록에서 삭제되면 downloadId와 함께 발생합니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (downloadId: number) => void

    • downloadId

      숫자