Событие: свойство cancelable

Чтение-только свойство cancelable интерфейса Event указывает, может ли событие быть отменено, и, следовательно, предотвращено, как если бы событие никогда не происходило.

Если событие не может быть отменено, то его свойство cancelable будет false, и обработчик события не может остановить возникновение события.

Большинство событий браузера, которые могут быть отменены, — это те, которые возникают в результате взаимодействия пользователя со страницей. Отмена событий click, wheel или beforeunload соответственно предотвратит нажатие пользователем на элемент, прокрутку страницы колесом мыши или переход от страницы.

Синтетические события, созданные другим JavaScript-кодом, определяют, могут ли они быть отменены при их создании.

Чтобы отменить событие, вызовите метод preventDefault() на событии. Это предотвратит выполнение действия по умолчанию, связанного с событием.

Обработчики событий, обрабатывающие несколько типов событий, могут захотеть проверить cancelable перед вызовом своих методов preventDefault().

Булево значение, которое равно true если событие может быть отменено.

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

function preventScrollWheel(event) {
  if (typeof event.cancelable !== "boolean" || event.cancelable) {
    // The event can be canceled, so we do so.
    event.preventDefault();
  } else {
    // The event cannot be canceled, so it is not safe
    // to call preventDefault() on it.
    console.warn(`The following event couldn't be canceled:`);
    console.dir(event);
  }
}

document.addEventListener("wheel", preventScrollWheel);