Spec-Zone.ru › Web APIs

console: метод assert() статический

Базовая поддержка Широко поддерживается

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в Web Workers.

Статический метод console.assert() выводит сообщение об ошибке в консоль, если утверждение ложно. Если утверждение истинно, ничего не происходит.

Синтаксис

console.assert(assertion)

console.assert(assertion, val1)
console.assert(assertion, val1, val2)
console.assert(assertion, val1, val2, /* …, */ valN)

console.assert(assertion, msg)
console.assert(assertion, msg, subst1)
console.assert(assertion, msg, subst1, /* …, */ substN)

Параметры

assertion

Любое булево выражение. Если утверждение ложно, в консоль записывается общее сообщение об ошибке утверждения.

val1 … valN

Список JavaScript-значений для вывода. Представление каждого из этих значений выводится в консоль после общего сообщения об ошибке утверждения (которое может отличаться от сообщения, выведенного, когда эти значения отсутствуют) в заданном порядке с каким-то типом разделителя между сообщением и каждым из них. Существует особый случай, если val1 является строкой, который описывается далее.

msg

Строка JavaScript, содержащая ноль или более строк подстановки, которые заменяются на subst1 до substN в последовательном порядке до числа строк подстановки. Двоеточие, пробел, а затем подставленная строка добавляются к общему сообщению об ошибке утверждения, чтобы сформировать подробное сообщение об ошибке утверждения, результат которого выводится в консоль. См. Использование строк подстановки для описания работы подстановок.

subst1 … substN

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

См. Вывод текста в консоль в документации по console для получения дополнительной информации.

Возвращаемое значение

Ничего (undefined).

Примеры

В следующем примере кода показано использование JavaScript-объекта после утверждения:

const errorMsg = "the # is not even";
for (let number = 2; number <= 5; number++) {
  console.log(`the # is ${number}`);
  console.assert(number % 2 === 0, "%o", { number, errorMsg });
}
// output:
// the # is 2
// the # is 3
// Assertion failed: {number: 3, errorMsg: "the # is not even"}
// the # is 4
// the # is 5
// Assertion failed: {number: 5, errorMsg: "the # is not even"}

Спецификации

Спецификация
Консоль
# assert

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на IOS Samsung Internet WebView Android
assert_static 2 12 28 11 4 18 28 11 3.2 1.0 ≤37

См. также

  • Документация Microsoft Edge по console.assert()
  • Документация Node.js по console.assert()
  • Документация Google Chrome по console.dir()

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/console/assert_static

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API