Как отключить правило TypeScript для конкретной строки?

Как отключить правило TypeScript для одной строки: полное руководство

В TypeScript есть несколько способов решить вашу проблему. Начну с самого простого, а затем покажу более правильные подходы.

1. Комментарий // @ts-ignore (самый быстрый, но не лучший)

Это стандартный способ отключить проверку типов для следующей строки:

// @ts-ignore
const editableDiv = editor.data('summernote').$editable;

Проблема: вы отключаете все проверки типов для этой строки, а не только конкретную ошибку. Если в этой строке будет опечатка или другая ошибка — TypeScript её пропустит.

2. Комментарий // @ts-expect-error (рекомендуемый)

Начиная с TypeScript 3.9, появился более безопасный вариант:

// @ts-expect-error - Summernote не имеет типов для $editable
const editableDiv = editor.data('summernote').$editable;

Плюс: если ошибки не будет (например, в будущем добавят типы), TypeScript сам сообщит, что комментарий лишний. Это помогает не забыть убрать костыль.

3. Правильное решение: приведение типов (type assertion)

Вместо отключения проверки лучше явно указать TypeScript, какой тип вы ожидаете:

interface SummernoteInstance {
  $editable: JQuery<HTMLElement>;
  // можно добавить другие поля, если нужно
}

const summernoteData = editor.data('summernote') as unknown as SummernoteInstance;
const editableDiv = summernoteData.$editable;

Или более короткая запись через as any:

const editableDiv = (editor.data('summernote') as any).$editable;

Но as any тоже отключает всю типизацию для этого выражения. Лучше использовать конкретный интерфейс.

4. Расширение глобальных типов (для частого использования)

Если вы часто работаете с Summernote, создайте файл summernote.d.ts:

// summernote.d.ts
interface JQuery {
  summernote(options?: any): any;
  data(key: 'summernote'): SummernoteInstance | undefined;
}

interface SummernoteInstance {
  $editable: JQuery<HTMLElement>;
  // другие поля...
}

Тогда код будет работать без костылей:

const editableDiv = editor.data('summernote')!.$editable;
// Оператор ! говорит TypeScript: "я уверен, что значение не null/undefined"

Итоговая рекомендация

• Для однократного использования — // @ts-expect-error с комментарием, почему это сделано.
• Если таких мест много — создайте файл декларации типов (.d.ts).
• Избегайте // @ts-ignore — он не сообщит, когда костыль станет ненужным.
• Не используйте as any без необходимости — это убивает всю пользу от TypeScript.

В вашем случае с Summernote я бы посоветовал создать файл типов, так как это популярная библиотека, и вы наверняка будете обращаться к её внутренностям не раз.

const editableDiv = (editor.data('summernote') as any)!.$editable;

const summernoteData = editor.data('summernote') as {
  $editable: JQuery<HTMLElement>;
  [key: string]: any; // разрешаем любые другие поля
};

const editableDiv = summernoteData.$editable;