From e09aacde1ce9a91b13d72b9d0119686c591b33b3 Mon Sep 17 00:00:00 2001 From: Sanzo Date: Sat, 1 Aug 2026 22:46:51 +0530 Subject: [PATCH] doc: clarify sqlite bare named parameter default Signed-off-by: Sanzo --- doc/api/sqlite.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/doc/api/sqlite.md b/doc/api/sqlite.md index 850358ff43aa..a608e82448ff 100644 --- a/doc/api/sqlite.md +++ b/doc/api/sqlite.md @@ -1134,13 +1134,14 @@ added: v22.5.0 without the prefix character. The names of SQLite parameters begin with a prefix character. By default, -`node:sqlite` requires that this prefix character is present when binding -parameters. However, with the exception of dollar sign character, these -prefix characters also require extra quoting when used in object keys. - -To improve ergonomics, this method can be used to also allow bare named -parameters, which do not require the prefix character in JavaScript code. There -are several caveats to be aware of when enabling bare named parameters: +`node:sqlite` allows bare named parameters because +`allowBareNamedParameters` defaults to `true`. When bare named parameters are +disabled, the prefix character is required when binding parameters. However, +with the exception of the dollar sign character, these prefix characters also +require extra quoting when used in object keys. + +This method enables or disables bare named parameters. There are several +caveats to be aware of when bare named parameters are enabled: * The prefix character is still required in SQL. * The prefix character is still allowed in JavaScript. In fact, prefixed names