Что такое…

Что такое шаблонная строка в JavaScript — и почему пара скобок открывает SQL-инъекцию

Иллюстрация: трафарет с прорезями, в которые встают детали, — и одна чужая заглушка

Посмотри на две строки кода. Отличаются они парой круглых скобок:

await sql`SELECT * FROM users WHERE id = ${id}`
await sql(`SELECT * FROM users WHERE id = ${id}`)

Первая безопасна. Во второй — классическая SQL-инъекция: если в id придёт 1 OR 1=1, запрос вернёт всех пользователей. В зависимости от библиотеки вторая строка либо упадёт с ошибкой, либо молча откроет дыру.

Почему пара скобок так всё меняет? Чтобы понять, нужно разобраться в шаблонных строках. Их пишут каждый день, но вторую их половину знают немногие.

Что такое шаблонная строка

Шаблонная строка (по-английски template literal) — это строка в обратных кавычках `. Обратная кавычка на клавиатуре живёт на клавише с буквой «ё».

Внутри можно вставлять любые выражения через ${...}:

const name = 'Аня'
const total = 3

`Привет, ${name}! В корзине ${total} товара`
// 'Привет, Аня! В корзине 3 товара'

Внутри ${} работает любой JavaScript: ${price * 2}, ${user.name.toUpperCase()}, ${isAdmin ? 'админ' : 'гость'}. Результат превращается в строку и встаёт на место.

Вторая суперсила — перенос строк. В обычных кавычках так нельзя, а в обратных — пожалуйста:

const message = `Заказ принят.
Ждите курьера.`

Про строки в целом — в статье что такое строка.

Две ловушки на каждый день

Обычные кавычки вместо обратных. Самая частая ошибка:

'Привет, ${name}'   // буквально выведет: Привет, ${name}

Подстановка работает только в обратных кавычках. В одинарных или двойных ${name} — просто символы. Ошибки нет, просто на экране кривой текст. У ESLint есть правило no-template-curly-in-string — оно ловит ровно это.

Подставляется не то, что ждёшь. Шаблон молча превращает в строку что угодно:

`${user}`       // '[object Object]'
`${[1, 2, 3]}`  // '1,2,3'
`${undefined}`  // 'undefined'

Видишь на странице «Привет, undefined» или «[object Object]» — ищи шаблонную строку, в которую попал не тот тип. Подробнее про такие значения — в статье про null и undefined.

И мелочь про переносы. Пробелы в начале строк тоже попадут в результат. Если шаблон с отступами живёт внутри функции, отступы окажутся в тексте письма или промпта.

Теговые шаблоны — вторая половина

Перед обратными кавычками можно поставить имя функции, без скобок. Это теговый шаблон (tagged template):

tag`Привет, ${name}! Тебе ${age}`

JavaScript не склеивает такую строку. Он вызывает функцию tag и передаёт ей части отдельно:

tag(['Привет, ', '! Тебе ', ''], name, age)

Первым аргументом — массив кусков текста. Дальше — значения, каждое отдельно. А функция сама решает, что с ними делать. Она может вернуть строку, объект или запрос в базу данных.

Встроенный пример — String.raw. Он не обрабатывает обратные слэши:

String.raw`C:\new\folder`   // 'C:\new\folder' — \n не стал переносом

Вернёмся к SQL

Теперь разница между двумя строками из начала становится видна.

sql`... ${id}` — это теговый шаблон. Библиотека получает текст запроса и значение id по отдельности. Значение уходит в базу как параметр. База никогда не исполнит его как кусок SQL. Что бы ни пришло в id, это просто данные.

sql(`... ${id}`) — сначала собирается обычная строка. Значение id вклеивается в текст запроса. Только потом готовая строка уходит в функцию. Отличить твой SQL от вклеенного злоумышленником уже невозможно.

Так устроены многие инструменты:

  • драйверы Postgres вроде postgres и @neondatabase/serverless — sql`...` ;
  • Prisma: $queryRaw`...` безопасен, а $queryRawUnsafe(...) с шаблоном внутри — нет;
  • шаблоны HTML вроде html`...` в библиотеке Lit экранируют значения и защищают от XSS.

Отсюда же вторая похожая дыра: element.innerHTML = `<b>${name}</b>`. Обычная шаблонная строка ничего не экранирует. Если name пришло от пользователя, в нём может оказаться скрипт. Про SQL как язык — в статье что такое SQL.

Как проверить код от ИИ

Нейросети любят собирать запросы шаблонной строкой — так короче. Перед деплоем найди в проекте:

  • query(, execute(, raw( с обратными кавычками внутри скобок;
  • Unsafe в названиях методов;
  • innerHTML = с шаблонной строкой справа.

Каждое место — кандидат на дыру. Попроси ИИ переписать его на теговый шаблон или параметры запроса.

Чем шаблонная строка отличается от обычной?

Она пишется в обратных кавычках, умеет вставлять значения через ${} и хранить переносы строк. В обычных кавычках ${} не работает и выводится как текст.

Можно ли вкладывать шаблонные строки друг в друга?

Да: внутри ${} можно написать ещё одну шаблонную строку. Но читать такое тяжело. Лучше вынеси кусок в переменную.

Шаблонные строки медленнее обычной склейки?

На практике нет. Разница теряется в шуме. Выбирай то, что легче читать.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →