Skip to main content

Class: DBQuery

@divine/uri.DBQuery

Constructors​

constructor​

• new DBQuery(query, params)

Constructs a new DBQuery object.

If one of the parameters is itself a DBQuery, the query will be merged with this one at constructon time and its parameters adopted.

This constructor is semi-private: You should use q, quote, raw, join, list, values or assign to construct queries, or just call query directly.

Throws

TypeError If one of the parameters is undefined or if a nested DBQuery is invalid.

Parameters​

NameTypeDescription
queryreadonly string[]The query segments, much like a template literal string array.
paramsunknown[]The parameters. There should be exactly one less parameter than query segments.

Defined in​

uri/src/protocols/database.ts:395

Accessors​

params​

• get params(): unknown[]

The parameters as an array

Returns​

unknown[]

Defined in​

uri/src/protocols/database.ts:431

Methods​

toString​

▸ toString(placeholder?): string

Converts this query into a string.

Parameters​

NameTypeDescription
placeholder(value: unknown, index: number, query: DBQuery) => stringA function that returns a placeholder for each parameter. Might return just ? or $1/$2/etc, or actually encode the parameter to make the resulting query safe for execution.

Returns​

string

The query as a string, with the parameters expanded by the placeholder function.

Defined in​

uri/src/protocols/database.ts:444