---
title: "Notifier API — показ уведомлений в Blok"
description: "Показ уведомлений об успехе, ошибке и подтверждении изнутри инструмента или из кода вашего приложения."
source: https://blokeditor.com/ru/docs/notifier-api/
lastmod: 2026-09-07
---

Фреймворк JavaScript

Интерфейс Уведомления

На этой странице notifier.show(options)

# Notifier API: показ уведомлений

Отображение уведомлений для пользователей. Отрисовка подключаемая: передайте `notifier: (options) => …` в конфигурации конструктора, и Blok вызовет ваш обработчик вместо собственной отрисовки — встроенный тост пропускается полностью (вместе со значениями `okText`/`cancelText` из i18n), а любая ошибка вашего обработчика доходит до места вызова `show()`. `notifierPosition` задаёт положение встроенного контейнера: 'bottom-left' | 'bottom-right' | 'bottom-center' | 'top-left' | 'top-right' | 'top-center' (по умолчанию 'bottom-center').

[Редактировать на GitHub](https://github.com/JackUait/blok/blob/main/docs/src/components/api/api-data.ts)

### Как получить экземпляр редактора

Методы ниже вызываются на редакторе, созданном через new Blok(). Они доступны после того, как разрешится editor.isReady.

TypeScript

```
// You already hold the instance returned by the constructor.
const editor = new Blok({ holder: 'editor' });
await editor.isReady;

// Call any API method on it.
editor.caret.setToLastBlock('end');
```

## Методы

### notifier.show(options)

void

Показать уведомление. Поддерживает простые уведомления, confirm и prompt.

Когда использовать

Встроенное уведомление для лёгкой обратной связи. `type: 'confirm'` или `'prompt'` — для ответа да/нет или текста.

Параметры

| Параметр | Тип | Обязательный | По умолчанию | Описание |
| --- | --- | --- | --- | --- |
| `options` | `NotifierOptions | ConfirmNotifierOptions | PromptNotifierOptions` | Обязательный | — | Конфигурация уведомления. Форма зависит от `type`. |
| `options.message` | `string` | Обязательный | — | Текст уведомления. Может содержать HTML. |
| `options.type` | `'alert' | 'confirm' | 'prompt'` | — | `'alert'` | Тип уведомления. `confirm` и `prompt` добавляют кнопки действий. |
| `options.style` | `'success' | 'error'` | — | `undefined` | Обозначает семантический вид уведомления. `'error'` повышает live-регион сообщения для скринридеров до `assertive` (иначе `polite`), а само значение попадает в `data-blok-testid` как `notification-success` / `notification-error`. Встроенный тост в обоих случаях выглядит одинаково — раскраски success/error нет. |
| `options.time` | `number` | — | `8000` | Время автозакрытия в мс для уведомлений-алертов (по умолчанию 8000). `confirm` и `prompt` — модальные и остаются на экране, пока пользователь не ответит. |
| `options.okText` | `string` | — | `i18n `notifier.confirm` / `notifier.ok` ('Confirm' / 'OK' in English)` | Текст кнопки подтверждения/отправки (только для `confirm`/`prompt`). |
| `options.okHandler` | `(event: Event) => void | (value: string) => void` | — | `undefined` | Колбэк подтверждения/отправки. Получает событие клика для `confirm` или значение поля для `prompt`. Обязателен для уведомлений типа prompt. |
| `options.cancelText` | `string` | — | `i18n `notifier.cancel` ('Cancel' in English)` | Текст кнопки отмены (типы `confirm` и `prompt`). |
| `options.cancelHandler` | `(event: Event) => void` | — | `undefined` | Колбэк отмены/закрытия. Вызывается (если передан) перед закрытием диалога по кнопке отмены, по закрытию или Esc — как для типа `confirm`, так и для `prompt`. |
| `options.inputType` | `string` | — | `'text'` | Тип HTML-поля ввода для текстового поля prompt (только для типа prompt). |
| `options.placeholder` | `string` | — | `undefined` | Текст плейсхолдера для поля ввода prompt (только для типа prompt). |
| `options.default` | `string` | — | `undefined` | Значение по умолчанию, предзаполненное в поле ввода prompt (только для типа prompt). |

Ошибки

- Модуль уведомлений не загрузился (например, заблокирован CSP, ошибка динамического импорта). [Blok] Failed to display notification. Reason: <error> Встроенный notifier никогда не выбрасывает ошибку и не отклоняет промис — проверьте консоль браузера, так как сбой только логируется, а не передаётся в точку вызова. С пользовательским обработчиком `config.notifier` всё иначе: он вызывается синхронно, и его исключения не перехватываются.

TypeScript

```
// Simple notification
editor.notifier.show({
  message: 'Changes saved',
  style: 'success'
});
// → renders a body-mounted, viewport-fixed toast (default: bottom-center —
//   see config.notifierPosition); returns nothing to await

// Confirm notification
editor.notifier.show({
  message: 'Delete this block?',
  type: 'confirm',
  okHandler: () => console.log('Confirmed'),
  cancelHandler: () => console.log('Cancelled')
});

// Prompt notification
editor.notifier.show({
  message: 'Enter a title',
  type: 'prompt',
  okHandler: (value) => console.log('Entered:', value)
});
```