Skip to main content

setAllowBareNamedParameters

method StatementSync.prototype.setAllowBareNamedParameters
Jump to headingStatementSync.prototype.setAllowBareNamedParameters(enabled: boolean): void

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:

  • The prefix character is still required in SQL.
  • The prefix character is still allowed in JavaScript. In fact, prefixed names will have slightly better binding performance.
  • Using ambiguous named parameters, such as $k and @k, in the same prepared statement will result in an exception as it cannot be determined how to bind a bare name.

Parameters Jump to heading

Jump to headingenabled: boolean

Enables or disables support for binding named parameters without the prefix character.

Return Type Jump to heading

void
Back to top