Как применить `@ts-ignore` для целого блока кода в TypeScript?

Прямого способа нет, но есть элегантные альтернативы

К сожалению, в TypeScript нет встроенной директивы для отключения проверки типов в целом блоке кода, такой как // @ts-ignore-block. Единственная официальная директива — это // @ts-ignore для одной строки или // @ts-expect-error (похожа, но выдаст предупреждение, если ошибки на самом деле нет). Однако это не значит, что вы обречены ставить 15 комментариев подряд. Есть несколько гораздо более чистых и поддерживаемых подходов.

Решение 1: Вынос проблемного кода в отдельный файл (рекомендуется)

Самый простой и правильный способ — вынести весь блок кода, где нужна отмена проверки типов, в отдельный файл с расширением .js (или .jsx), а затем импортировать его в основной .ts файл. TypeScript по умолчанию проверяет .js файлы с гораздо меньшей строгостью (если не включены опции checkJs и strict). Таким образом, вы изолируете "грязный" код.

// ---- dataLoader.js (без проверки типов) ----
function loadData() {
    const data = require('./data.json');
    const name = data.user.name;
    const age = data.user.age;
    const city = data.user.address.city;
    return { name, age, city };
}
module.exports = { loadData };

// ---- main.ts (строгая типизация) ----
import { loadData } from './dataLoader';
const result = loadData(); // result имеет тип any, но это лучше, чем 15 @ts-ignore
console.log(result.name);

Решение 2: Использование // @ts-ignore с умом

Если вы не хотите создавать новый файл, можно объединить несколько строк в одну операцию, чтобы сократить количество комментариев. Например, если вы присваиваете результат цепочки вызовов одной переменной, достаточно одного // @ts-ignore перед этой строкой.

// @ts-ignore
const data: any = require('./data.json');
// Теперь data имеет тип any, и все последующие обращения к нему не будут проверяться
const name = data.user.name;
const age = data.user.age;
const city = data.user.address.city;

Решение 3: Подавление ошибок через tsconfig.json

Если проблема связана с конкретной библиотекой или паттерном (например, импорт JSON), лучше настроить компилятор глобально. Для импорта JSON включите "resolveJsonModule": true в tsconfig.json. Если проблема в неявном any, можно временно отключить "noImplicitAny": false, но это грубое решение.

{
  "compilerOptions": {
    "resolveJsonModule": true,
    "esModuleInterop": true
  }
}

Решение 4: Кастомная обёртка с as any

Вы можете написать небольшую функцию-обёртку, которая явно приводит результат к any:

function loadUntyped<T>(fn: () => T): T {
    // @ts-ignore
    return fn();
}

const data = loadUntyped(() => require('./data.json'));
// data теперь any

Итог: Не пытайтесь найти несуществующий @ts-ignore-block. Вместо этого используйте один из предложенных методов. Лично я рекомендую вынос в .js файл — это сохраняет строгость типов в основном коде и не загромождает его комментариями.

// @ts-nocheck
// Весь этот файл не будет проверяться TypeScript
const data = require('./data.json');
const name = data.user.name;
const age = data.user.age;
const city = data.user.address.city;