chrome.downloads

속성

• 현재

  불리언 선택사항

• 이전

  불리언 선택사항

열거형

속성

• 현재

  숫자 선택사항

• 이전

  숫자 선택사항

속성

• 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의 변경사항입니다(있는 경우).

속성

• byExtensionId

  문자열(선택사항)

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

• byExtensionName

  문자열(선택사항)

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

• bytesReceived

  숫자

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

• canResume

  부울

  다운로드가 진행 중이고 일시중지 상태인 경우 'true'입니다. 다운로드가 중단되고 중단된 위치부터 다시 시작할 수 있는 경우 'true'입니다.

• 위험

  DangerType

  이 다운로드에 안전한 다운로드인지 또는 의심스러운 다운로드인지에 대한 표시

• endTime

  문자열(선택사항)

  다운로드가 종료된 시간입니다(ISO 8601 형식). 날짜 생성자에 직접 전달할 수 있습니다. 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 형식으로 표시합니다. 날짜 생성자에 직접 전달할 수 있습니다. 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

  숫자

  브라우저 세션 전체에서 유지되는 식별자입니다.

• 시크릿 모드

  부울

  이 다운로드가 기록에 기록된 경우 거짓, 기록되지 않은 경우 참입니다.

• 마임

  문자열

  파일의 MIME 유형입니다.

• 일시중지됨

  부울

  다운로드가 호스트에서 데이터 읽기를 중지했지만 연결은 열어 둔 경우 참입니다.

• 리퍼러

  문자열

  절대 URL입니다.

• startTime

  문자열

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

• 주

  상태

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

• totalBytes

  숫자

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

• URL

  문자열

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

속성

• 본문

  문자열(선택사항)

  게시물 본문입니다.

• 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입니다.

속성

• 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')을 접두사로 추가합니다.

• 일시중지됨

  불리언 선택사항

  다운로드가 호스트에서 데이터 읽기를 중지했지만 연결은 열어 둔 경우 참입니다.

• 검색어

  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로 결과를 제한합니다.

열거형

속성

• conflictAction

  FilenameConflictAction 선택사항

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

• filename

  문자열

  DownloadItem의 새로운 타겟 DownloadItem.filename: 사용자의 기본 Downloads 디렉터리에 대한 상대 경로로, 하위 디렉터리를 포함할 수 있습니다. 절대 경로, 빈 경로, 역참조 '..'가 포함된 경로 무시됩니다. 확장 프로그램에서 등록한 onDeterminingFilename 리스너가 있으면 filename가 무시됩니다.

속성

• 크기

  숫자 선택사항

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

속성

• 이름

  문자열

  HTTP 헤더의 이름입니다.

• 값

  문자열

  HTTP 헤더의 값입니다.

열거형

열거형

열거형

속성

• 현재

  문자열(선택사항)

• 이전

  문자열(선택사항)

속성

• 사용 설정됨

  부울

  다운로드 UI를 사용 설정 또는 사용 중지합니다.

매개변수

• downloadId

  숫자

  DownloadItem의 식별자입니다.

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

매개변수

• downloadId

  숫자

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

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

매개변수

• 옵션

  DownloadOptions

  다운로드할 콘텐츠 및 다운로드 방법

• 콜백

  함수 선택사항

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

  (downloadId: number) => void

  • downloadId

    숫자

반환 값

• Promise&lt;number&gt;

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

매개변수

• 검색어

  DownloadQuery

• 콜백

  함수 선택사항

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

  (erasedIds: number[]) => void

  • erasedIds

    숫자[]

반환 값

• 프로미스<숫자[]>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

매개변수

• downloadId

  숫자

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

• 옵션

  GetFileIconOptions 선택사항

• 콜백

  함수 선택사항

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

  (iconURL?: string) => void

  • iconURL

    문자열(선택사항)

반환 값

• 프로미스<문자열 | 정의되지 않음>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

매개변수

• downloadId

  숫자

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

• 콜백

  함수 선택사항

  Chrome 123 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

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

  () => void

반환 값

• 프로미스<void>

  Chrome 123 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

매개변수

• downloadId

  숫자

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

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

매개변수

• downloadId

  숫자

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

매개변수

• downloadId

  숫자

  다시 시작할 다운로드의 ID입니다.

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

매개변수

• 검색어

  DownloadQuery

• 콜백

  함수 선택사항

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

  (results: DownloadItem[]) => void

  • 결과

    DownloadItem[]

반환 값

• Promise&lt;DownloadItem[]&gt;

  Chrome 96 이상 를 통해 개인정보처리방침을 정의할 수 있습니다.

  프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

매개변수

• 사용 설정됨

  부울

매개변수

• 옵션

  UiOptions

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

• 콜백

  함수 선택사항

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

  () => void

반환 값

• 프로미스<void>

  프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

매개변수

• downloadId

  숫자

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

매개변수

• 콜백

  함수

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

  (downloadDelta: DownloadDelta) => void

  • downloadDelta

    DownloadDelta

매개변수

• 콜백

  함수

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

  (downloadItem: DownloadItem) => void

  • downloadItem

    DownloadItem

매개변수

• 콜백

  함수

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

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

  • downloadItem

    DownloadItem

  • suggest

    함수

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

    (suggestion?: FilenameSuggestion) => void

    • 추천

      FilenameSuggestion 선택사항

매개변수

• 콜백

  함수

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

  (downloadId: number) => void

  • downloadId

    숫자