formatQuery()

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny): string

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:243

Generates a formatted (indented two spaces) JSON string from a query object.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny

Returns

string

Call Signature

formatQuery<TResult>(ruleGroup: RuleGroupTypeAny, options: FormatQueryOptions & { ruleGroupProcessor: RuleGroupProcessor<TResult>; }): TResult

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:249

Generates a result based on the provided rule group processor.

Type Parameters

Type Parameter	Default type
TResult	unknown

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	FormatQueryOptions & { ruleGroupProcessor: RuleGroupProcessor<TResult>; }

Returns

TResult

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "parameterized" | FormatQueryOptions & { format: "parameterized"; }): ParameterizedSQL

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:258

Generates a ParameterizedSQL object from a query object.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"parameterized" | FormatQueryOptions & { format: "parameterized"; }

Returns

ParameterizedSQL

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "parameterized_named" | FormatQueryOptions & { format: "parameterized_named"; }): ParameterizedNamedSQL

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:267

Generates a ParameterizedNamedSQL object from a query object.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"parameterized_named" | FormatQueryOptions & { format: "parameterized_named"; }

Returns

ParameterizedNamedSQL

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "jsonlogic" | FormatQueryOptions & { format: "jsonlogic"; }): RQBJsonLogic

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:276

Generates a JsonLogic object from a query object.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"jsonlogic" | FormatQueryOptions & { format: "jsonlogic"; }

Returns

RQBJsonLogic

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "elasticsearch" | FormatQueryOptions & { format: "elasticsearch"; }): Record<string, any>

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:289

Generates an ElasticSearch query object from an RQB query object.

NOTE: Support for the ElasticSearch format is experimental. You may have better results exporting "sql" format then using ElasticSearch SQL.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"elasticsearch" | FormatQueryOptions & { format: "elasticsearch"; }

Returns

Record<string, any>

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "mongodb_query" | FormatQueryOptions & { format: "mongodb_query"; }): Record<string, any>

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:302

Generates a MongoDB query object from an RQB query object.

This is equivalent to the "mongodb" format, but returns a JSON object instead of a string.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"mongodb_query" | FormatQueryOptions & { format: "mongodb_query"; }

Returns

Record<string, any>

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "mongodb" | FormatQueryOptions & { format: "mongodb"; }): string

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:317

Generates a JSON.stringify'd MongoDB query object from an RQB query object.

This is equivalent to the "mongodb_query" format, but returns a string instead of a JSON object.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"mongodb" | FormatQueryOptions & { format: "mongodb"; }

Returns

string

Deprecated

Use the "mongodb_query" format for greater flexibility.

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "prisma" | FormatQueryOptions & { format: "prisma"; }): Record<string, any>

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:326

Generates a Prisma ORM query object from an RQB query object.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"prisma" | FormatQueryOptions & { format: "prisma"; }

Returns

Record<string, any>

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "drizzle" | FormatQueryOptions & { format: "drizzle"; }): DrizzleWhereCallback

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:337

Generates a Drizzle ORM query function from an RQB query object. The function can be assigned to the where property in the Drizzle relational queries API.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"drizzle" | FormatQueryOptions & { format: "drizzle"; }

Returns

DrizzleWhereCallback

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "tanstack_db" | FormatQueryOptions & { format: "tanstack_db"; }): TanStackDbWhereCallback

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:347

Generates a TanStack DB WhereCallback from an RQB query object. The callback can be passed directly to TanStack DB's .where() method.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"tanstack_db" | FormatQueryOptions & { format: "tanstack_db"; }

Returns

TanStackDbWhereCallback

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "sequelize" | FormatQueryOptions & { format: "sequelize"; }): SequelizeWhereOptionsLike | undefined

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:356

be assigned to the where property in the Sequelize query functions.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"sequelize" | FormatQueryOptions & { format: "sequelize"; }

Returns

SequelizeWhereOptionsLike | undefined

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "jsonata" | FormatQueryOptions & { format: "jsonata"; }): string

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:368

Generates a JSONata query string from an RQB query object.

NOTE: Either parseNumbers: "strict-limited" or parseNumbers: true are recommended for this format.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"jsonata" | FormatQueryOptions & { format: "jsonata"; }

Returns

string

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "ldap" | FormatQueryOptions & { format: "ldap"; }): string

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:377

Generates an LDAP query string from an RQB query object.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"ldap" | FormatQueryOptions & { format: "ldap"; }

Returns

string

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "diagnostics" | FormatQueryOptions & { format: "diagnostics"; }): DiagnosticsResult

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:387

Generates a DiagnosticsResult from a query object, containing an annotated query tree, a flat diagnostics array, aggregate stats, and a per-field summary.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"diagnostics" | FormatQueryOptions & { format: "diagnostics"; }

Returns

DiagnosticsResult

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: FormatQueryOptions): string

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:396

Generates a formatted (indented two spaces) JSON string from a query object.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	FormatQueryOptions

Returns

string

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: "sequelize" | "json" | "sql" | "json_without_ids" | "mongodb" | "cel" | "spel" | "natural_language" | "ldap" | "drizzle" | "tanstack_db" | "prisma" | "cypher" | "gql" | "sparql" | "gremlin"): string

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:402

Generates a query string in the requested format.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	"sequelize" | "json" | "sql" | "json_without_ids" | "mongodb" | "cel" | "spel" | "natural_language" | "ldap" | "drizzle" | "tanstack_db" | "prisma" | "cypher" | "gql" | "sparql" | "gremlin"

Returns

string

Call Signature

formatQuery(ruleGroup: RuleGroupTypeAny, options: FormatQueryOptions & { format: "sequelize" | "json" | "sql" | "json_without_ids" | "mongodb" | "cel" | "spel" | "natural_language" | "ldap" | "drizzle" | "tanstack_db" | "prisma" | "cypher" | "gql" | "sparql" | "gremlin"; }): string

Defined in: packages/core/src/utils/formatQuery/formatQuery.ts:411

Generates a query string in the requested format.

Parameters

Parameter	Type
ruleGroup	RuleGroupTypeAny
options	FormatQueryOptions & { format: "sequelize" | "json" | "sql" | "json_without_ids" | "mongodb" | "cel" | "spel" | "natural_language" | "ldap" | "drizzle" | "tanstack_db" | "prisma" | "cypher" | "gql" | "sparql" | "gremlin"; }

Returns

string

---

caution

API documentation is generated from the latest commit on the main branch. It may be somewhat inconsistent with official releases of React Query Builder.