Устаревшая функциональность

Здесь собрано то, что помечено устаревшим в публичном API Q.Palette. Пока пометка действует, функциональность работает как прежде — переходить на замену можно в удобном темпе, но до выхода мажорной версии, в которой её удалят.

Здесь только публичное API. Платформенная кухня — имена с приставкой ɵ и всё, что импортируется не из основного пути пакета, — сюда не попадает: она меняется без объявления устаревания, и продуктам её использовать нельзя.

Подключение библиотек: forRoot() → provideQ*()

Модули с forRoot() устарели: подключайте функциональность функциями на корневом уровне приложения. Вызовы forRoot() после перехода не действуют и удаляются из продукта. Подробности — в инструкции по переходу на Single Bundle.

Там же устарел прежний способ передачи провайдеров: createApplication(providers) и bootstrapStandalone() заменяются на createApplication().bootstrap(component, providers). Режим Single Bundle (provideSingleBundle(), константа Q_WEB_COMPONENT_SERVICES) уступает место режиму Standalone.

Переименованные классы и сервисы

Переименованные методы и свойства

Настройки конфигурации

Раздача воркера pdf.js рутовым приложением

Начиная с 8.0.37 просмотрщик берёт воркер из ассетов своей сборки, и его версия всегда совпадает с версией pdfjs-dist в вашем приложении. Рутовое приложение продолжает раздавать файл версии 5.6.205 только ради веб-компонентов, собранных до 8.0.37: с воркером 6.x их просмотрщик повисает.

Этот файл содержит CVE-2026-16633 — выполнение стороннего кода из вредоносного PDF. В линии 5.x исправления нет, оно только в 6.2.108, поэтому обновить раздаваемый файл невозможно. Единственное лечение — обновиться на 8.0.37 или новее и добавить правило копирования воркера, как описано в статье Просмотр и печать файлов.

Конфигурация серч-бокса через pbc-config

Пошаговый переход — в статье Серч-бокс: переход с pbc-config на JSON: как перенести конфигурацию в main.json, подключить её через qSearchBoxEndpoint и убрать из проекта остатки pbc-config.

Как перейти

Замены, где старый и новый код устроены по-разному, — со сравнением до и после.

events, isAuthenticated(), checkAuthorization() → authenticated$

Три способа узнать состояние авторизации заменены одним. authenticated$ отличается от потока событий тем, что имеет текущее значение: подписчик получает его сразу, а не ждёт следующего входа или выхода. Кроме того, поток учитывает вход, выполненный соседним бандлом на той же странице, — события такого входа не приносили.

// Было: текущее состояние отдельно, переходы отдельно
if (this.auth.isAuthenticated()) { this.load(); }
this.auth.events.subscribe((event) => {
  if (event === 'logout') { this.reset(); }
});
 
// Стало: и то, и другое выводится из одного потока
this.auth.authenticated$.subscribe((authenticated) => {
  if (authenticated) { this.load(); } else { this.reset(); }
});

Если нужен именно переход, а не состояние, возьмите пару соседних значений:

this.auth.authenticated$.pipe(pairwise())
  .subscribe(([was, is]) => {
    if (was && !is) { this.onLogout(); }
  });

checkAuthorization() выглядел как «спросить провайдера, жива ли сессия», но на деле это процедура старта приложения: у режима oidc она уводит на страницу провайдера, не найдя сессии, у iamproxy — на страницу аутентификации при 401, у flextera — завершает оборвавшуюся сессию. Вызов из микрофронтенда уводит со страницы всё приложение. Состояние к моменту, когда продукт получает управление, уже известно — читайте authenticated$.

Сервисы режимов → QAuthService

Пять сервисов режимов — QMdpAuthService, QOidcAuthService, QKeycloakAuthService, QFlexterraAuthService, QIamproxyAuthService — годились только для приведения типа: в контейнере зависимостей все они зарегистрированы под QAuthService, поэтому инъекция по этим токенам не работала и раньше. QAuthService даёт единый контракт независимо от режима — продукту знать режим незачем.

// Было: приведение к типу режима ради его собственных методов
const oidc = this.auth as unknown as QOidcAuthService;
oidc.signInRedirect();
 
// Стало: один контракт на все режимы — signIn() сам решает,
// показать форму продукта или увести к провайдеру
this.auth.signIn();

getUserInfo() → currentUser

Метод и свойство возвращают одно и то же — QUserInfo или null. Замена дословная:

const user = this.auth.currentUser;   // было: this.auth.getUserInfo()

Нестандартные поля из токена или профиля провайдера доступны в currentUser.extra — разбирать ключ доступа самостоятельно не нужно. Подробности — в статье Авторизация.

QReportsService → QJasperReportsService

Старый сервис принимал логин с паролем и требовал передавать ключ доступа в каждый метод, хотя ключ подставляет перехватчик из @diasoft/qpalette-auth. Соответствие методов:

Примеры вызовов — в статье Просмотр и печать файлов.