alarms.get()

根据名称获取一个闹钟。

这是一个异步函数,返回一个 Promise

语法

js
let getAlarm = browser.alarms.get(
  name                   // optional string
)

参数

name 可选

string。要获取的闹钟的名称。如果不提供此参数,则使用空字符串 ""。

返回值

一个 Promise,它将以一个 Alarm 对象 fulfilled。这代表名称与 name 匹配的闹钟。如果没有匹配的闹钟,则为 undefined

示例

js
function gotAlarm(alarm) {
  if (alarm) {
    console.log(alarm.name);
  }
}

let getAlarm = browser.alarms.get("my-periodic-alarm");
getAlarm.then(gotAlarm);

浏览器兼容性

注意: 此 API 基于 Chromium 的 chrome.alarms API。