Функция $.error()

Определение и применение

Функция $.error() выбрасывает исключение с заданным сообщением. В старых плагинах она служила общей точкой для сообщения о неверных параметрах или неизвестном имени метода.

Синтаксис

JavaScript

$.error(message);

Параметры и возвращаемое значение

message — строка сообщения. Функция создаёт и выбрасывает Error; нормального возвращаемого значения нет. Код после вызова не выполняется, если исключение не перехвачено выше по стеку.

Чтобы восстановиться после ожидаемой ошибки, используйте try/catch вокруг операции. Перехват должен принимать решение о дальнейшем поведении, а не просто скрывать сбой.

Особенности и совместимость

Функция доступна с 1.4.1 и присутствует в 4.0. Для собственного нового кода обычно достаточно throw new Error(message): библиотека для этого не нужна.

$.error() не является обработчиком неуспешного AJAX-запроса и не записывает сообщение без остановки выполнения. Для AJAX-отказа предназначен .fail() объекта запроса, для обычной записи в журнал — средства консоли.

Документация

jQuery.error — jQuery API

Пример использования

Сообщение об ошибочной настройке: попробуйте сами

Неизвестный режим вызывает Error. Перехват выводит тип ошибки и сообщение. Используется jQuery 4.0.0.

index.html

HTML

<pre id="result"></pre>

main.js

JavaScript

try {
    $.error('Неизвестный режим')
} catch (error) {
    $('#result').text(error.name + ': ' + error.message)
}