chrome.notifications

refresh date: 2026-09-25 robots: noindex

설명

chrome.notifications API를 사용하여 템플릿으로 리치 알림을 만들고 작업 표시줄에서 사용자에게 이러한 알림을 표시합니다.

권한

notifications

유형

NotificationBitmap

NotificationButton

속성

  • iconUrl

    문자열 선택사항

    Chrome 59부터 지원 중단됨

    Mac OS X 사용자에게 버튼 아이콘이 표시되지 않습니다.

  • 제목

    문자열

NotificationItem

속성

  • 메시지

    문자열

    이 항목에 대한 추가 세부정보입니다.

  • 제목

    문자열

    목록 알림의 항목 제목입니다.

NotificationOptions

속성

  • appIconMaskUrl

    문자열 선택사항

    Chrome 59부터 지원 중단됨

    Mac OS X 사용자에게는 앱 아이콘 마스크가 표시되지 않습니다.

    앱 아이콘 마스크의 URL입니다. URL에는 iconUrl과 동일한 제한사항이 있습니다.

    이미지의 알파 채널만 고려되므로 앱 아이콘 마스크는 알파 채널에 있어야 합니다.

  • 버튼

    NotificationButton[] 선택사항

    최대 2개의 알림 작업 버튼에 대한 텍스트 및 아이콘

  • contextMessage

    문자열 선택사항

    더 가벼운 글꼴을 사용하는 대체 알림 콘텐츠

  • eventTime

    number 선택사항

    알림과 연결된 타임스탬프이며 에포크 이후 밀리초 단위입니다 (예: Date.now() + n).

  • iconUrl

    문자열 선택사항

    발신자의 아바타, 앱 아이콘 또는 이미지 알림의 썸네일 URL입니다.

    URL은 데이터 URL, blob URL 또는 이 확장 프로그램의 .crx 파일 내 리소스와 관련된 URL일 수 있습니다.

    **참고:**이 값은 notifications.create() 메서드에 필요합니다.

  • imageUrl

    문자열 선택사항

    Chrome 59부터 지원 중단됨

    Mac OS X 사용자에게는 이미지가 표시되지 않습니다.

    이미지 유형 알림의 이미지 썸네일 URL입니다. URL에는 iconUrl과 동일한 제한사항이 있습니다.

  • isClickable

    불리언 선택사항

    Chrome 67부터 지원 중단됨

    이 UI 힌트는 Chrome 67부터 무시됩니다.

  • 항목

    NotificationItem[] 선택사항

    여러 항목 알림의 항목입니다. Mac OS X 사용자는 첫 번째 항목만 볼 수 있습니다.

  • 메시지

    문자열 선택사항

    기본 알림 콘텐츠입니다.

    **참고:**이 값은 notifications.create() 메서드에 필요합니다.

  • 우선순위

    number 선택사항

    우선순위 범위는 -2에서 2까지입니다. -2는 가장 낮은 우선순위입니다. 2가 가장 높습니다. 기본값은 0입니다. 알림 센터를 지원하지 않는 플랫폼 (Windows, Linux, Mac)에서는 -2 및 -1이 오류를 일으킵니다. 해당 우선순위의 알림은 전혀 표시되지 않기 때문입니다.

  • 진행률

    number 선택사항

    현재 진행 상황은 0에서 100 사이입니다.

  • requireInteraction

    불리언 선택사항

    Chrome 50 이상

    사용자가 알림을 활성화하거나 닫을 때까지 알림이 화면에 계속 표시되어야 함을 나타냅니다. 기본값은 false입니다.

  • 무음

    불리언 선택사항

    Chrome 70 이상

    알림이 표시될 때 소리나 진동이 발생하지 않아야 함을 나타냅니다. 기본값은 false입니다.

  • 제목

    문자열 선택사항

    알림 제목입니다 (예: 이메일 발신자 이름).

    **참고:**이 값은 notifications.create() 메서드에 필요합니다.

  • 유형

    TemplateType 선택사항

    표시할 알림 유형입니다. notifications.create 메서드에 필요합니다.

PermissionLevel

열거형

'granted'
사용자가 앱 또는 확장 프로그램의 알림을 표시하도록 선택했음을 지정합니다. 설치 시 기본값입니다.

'denied'
사용자가 앱 또는 확장 프로그램의 알림을 표시하지 않도록 선택했음을 지정합니다.

TemplateType

열거형

'basic'
아이콘, 제목, 메시지, expandedMessage, 최대 2개의 버튼을 포함합니다.

'image'
아이콘, 제목, 메시지, expandedMessage, 이미지, 최대 2개의 버튼을 포함합니다.

'list'
아이콘, 제목, 메시지, 항목, 최대 2개의 버튼을 포함합니다. Mac OS X 사용자는 첫 번째 항목만 볼 수 있습니다.

'progress'
아이콘, 제목, 메시지, 진행률, 최대 2개의 버튼을 포함합니다.

메서드

clear()

Promise 
chrome.notifications.clear(
  notificationId: string,
  callback?: function,
): Promise<boolean>

지정된 알림을 지웁니다.

매개변수

  • notificationId

    문자열

    삭제할 알림의 ID입니다. notifications.create 메서드에서 반환됩니다.

  • callback

    함수 선택사항

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

    (wasCleared: boolean) => void

    • wasCleared

      부울

반환 값

  • Promise<boolean>

    Chrome 116 이상

    일치하는 알림이 있는지 여부를 나타내는 프로미스를 반환합니다.

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

create()

Promise 
chrome.notifications.create(
  notificationId?: string,
  options: NotificationOptions,
  callback?: function,
): Promise<string>

알림을 만들고 표시합니다.

매개변수

  • notificationId

    문자열 선택사항

    알림의 식별자입니다. 설정하지 않거나 비어 있으면 ID가 자동으로 생성됩니다. 기존 알림과 일치하는 경우 이 메서드는 먼저 해당 알림을 지운 후 생성 작업을 진행합니다. 식별자는 500자(영문 기준) 이하여야 합니다.

    Chrome 42 이전에는 notificationId 매개변수가 필요합니다.

  • 알림의 내용입니다.

  • callback

    함수 선택사항

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

    (notificationId: string) => void

    • notificationId

      문자열

반환 값

  • Promise<string>

    Chrome 116 이상

    생성된 알림을 나타내는 알림 ID (제공되거나 생성됨)로 확인되는 프로미스를 반환합니다.

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

getAll()

Promise 
chrome.notifications.getAll(
  callback?: function,
): Promise<object>

이 앱 또는 확장 프로그램의 모든 알림을 가져옵니다.

매개변수

  • callback

    함수 선택사항

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

    (notifications: object) => void

    • 알림

      객체

반환 값

  • <span class="notranslate">Promise<object></span>

    Chrome 116 이상

    현재 시스템에 있는 notification_id 집합으로 확인되는 프로미스를 반환합니다.

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

getPermissionLevel()

Promise 
chrome.notifications.getPermissionLevel(
  callback?: function,
): Promise<PermissionLevel>

사용자가 이 앱 또는 확장 프로그램의 알림을 사용 설정했는지 여부를 가져옵니다.

매개변수

반환 값

  • Promise<PermissionLevel>

    Chrome 116 이상

    현재 권한 수준으로 확인되는 프로미스를 반환합니다.

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

update()

Promise 
chrome.notifications.update(
  notificationId: string,
  options: NotificationOptions,
  callback?: function,
): Promise<boolean>

기존 알림을 업데이트합니다.

매개변수

  • notificationId

    문자열

    업데이트할 알림의 ID입니다. notifications.create 메서드에서 반환됩니다.

  • 업데이트할 알림의 콘텐츠입니다.

  • callback

    함수 선택사항

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

    (wasUpdated: boolean) => void

    • wasUpdated

      부울

반환 값

  • Promise<boolean>

    Chrome 116 이상

    일치하는 알림이 있는지 여부를 나타내는 프로미스를 반환합니다.

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

이벤트

onButtonClicked

chrome.notifications.onButtonClicked.addListener(
  callback: function,
)

사용자가 알림에서 버튼을 눌렀습니다.

매개변수

  • callback

    함수

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

    (notificationId: string, buttonIndex: number) => void

    • notificationId

      문자열

    • buttonIndex

      숫자

onClicked

chrome.notifications.onClicked.addListener(
  callback: function,
)

사용자가 알림의 버튼이 아닌 영역을 클릭했습니다.

매개변수

  • callback

    함수

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

    (notificationId: string) => void

    • notificationId

      문자열

onClosed

chrome.notifications.onClosed.addListener(
  callback: function,
)

시스템 또는 사용자 작업에 의해 알림이 종료되었습니다.

매개변수

  • callback

    함수

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

    (notificationId: string, byUser: boolean) => void

    • notificationId

      문자열

    • byUser

      부울

onPermissionLevelChanged

chrome.notifications.onPermissionLevelChanged.addListener(
  callback: function,
)

사용자가 권한 수준을 변경합니다. Chrome 47부터 ChromeOS에만 이 이벤트를 전달하는 UI가 있습니다.

매개변수

onShowSettings

Chrome 65부터 지원 중단됨
chrome.notifications.onShowSettings.addListener(
  callback: function,
)

맞춤 알림 설정 버튼은 더 이상 지원되지 않습니다.

사용자가 앱의 알림 설정 링크를 클릭했습니다. Chrome 47부터 ChromeOS에만 이 이벤트를 전달하는 UI가 있습니다. Chrome 65부터는 ChromeOS에서도 해당 UI가 삭제되었습니다.

매개변수

  • callback

    함수

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

    () => void