alarms.create()

name Необязательно

string. Имя напоминания. По умолчанию пустая строка.

Может использоваться для указания конкретного напоминания в alarms.get() и alarms.clear(). Также будет доступно в alarms.onAlarm в качестве свойства name объекта alarms.Alarm, переданного в функцию-обработчик.

Имена напоминаний уникальны в рамках одного расширения. Если напоминание с таким же именем уже существует, существующее напоминание будет очищено, и создаваемое напоминание его заменит.

alarmInfo Необязательно

object. Можно использовать для указания момента первоначального срабатывания напоминания, либо как абсолютное значение (when), либо как задержка от момента установки напоминания (delayInMinutes). Чтобы сделать напоминание повторяющимся, укажите periodInMinutes.

В Chrome, если расширение не загружено в режиме разработки, созданные им напоминания не могут срабатывать чаще, чем раз в минуту. Если расширение пытается установить delayInMinutes со значением < 1 или when со значением < 1 минуты в будущем, напоминание сработает через 1 минуту. Если расширение пытается установить periodInMinutes со значением < 1, напоминание будет срабатывать каждую минуту.

Объект alarmInfo может содержать следующие свойства:

when Необязательно

double. Время первого срабатывания напоминания, заданное в миллисекундах с момента эпохи Unix. Чтобы получить количество миллисекунд между эпохой и текущим временем, используйте Date.now(). Если вы указываете when, не указывайте delayInMinutes.

delayInMinutes Необязательно

double. Время первого срабатывания напоминания, заданное в минутах от момента установки напоминания. Если вы указываете delayInMinutes, не указывайте when.

periodInMinutes Необязательно

double. Если это указано, напоминание будет срабатывать каждые periodInMinutes после первоначального срабатывания. Если вы указываете это значение, можно опустить как when, так и delayInMinutes, и напоминание сработает первоначально через periodInMinutes. Если periodInMinutes не указано, напоминание сработает только один раз.

Создайте напоминание с одним срабатыванием, основанное на задержке, с "" для имени:

const delayInMinutes = 5;

browser.alarms.create({
  delayInMinutes,
});

Создайте повторяющееся напоминание, основанное на задержке, с именем "my-periodic-alarm":

const delayInMinutes = 5;
const periodInMinutes = 2;

browser.alarms.create("my-periodic-alarm", {
  delayInMinutes,
  periodInMinutes,
});

Создайте повторяющееся напоминание с абсолютным временем срабатывания, с именем "my-periodic-alarm":

const when = 1545696000;
const periodInMinutes = 2;

browser.alarms.create("my-periodic-alarm", {
  when,
  periodInMinutes,
});