Awesome

Prisma Query Formatter

This small zero-dependency utility correctly formats Prisma queries by substituting placeholders with their corresponding values, support all databases including PostgreSQL.

Internally, Prisma uses its own Rust implementation for stringifying params, so you couldn't just use JSON.parse to convert them back to an array (sometimes it's not valid json, like double quotes are not escaped in strings).

Note that this utility is designed for logging purposes only, because Prisma irreversibly converts some types of parameters, such as blobs.

How to use it

Just register a query event handler and use the formatQuery util to substitute the query params (don't forget to enable event-based logging in your Prisma client configuration).

import { PrismaClient } from "@prisma/client";
import { formatQuery } from "prisma-query-formatter";

const prisma = new PrismaClient({
  log: [
    { emit: "event", level: "query" },
  ],
});

prisma.$on("query", (e) => {
  console.log(formatQuery(e.query, e.params));
});

For example, this query:

await db.user.findUnique({
  select: { id: true },
  where: { email: "john@example.com" },
});

Will be logged to the console as:

SELECT `User`.`id` FROM `User` WHERE `User`.`email` = "john@example.com"

Error handling

The library now performs a validation to ensure that the number of placeholders in a query matches the number of params, as a mismatch may indicate an error.

• If there is a mismatch and the option throwOnError is set to true, it will throw an error
• If throwOnError is set to false (default value), it will return the concatenated query and parameters as is

Here is an example with error handler:

prisma.$on("query", (e) => {
  try {
    console.log(formatQuery(e.query, e.params, { throwOnError: true }));
  } catch {
    console.log(`${e.query} ${e.params}`);
  }
});

Query formatting

All whitespace symbols in multiline queries (usually raw queries written manually) will be replaced with single space, for example:

await db.$queryRaw`
  SELECT 
    DISTINCT role
  FROM User
  WHERE
    status = ${Status.Active}
`;

Will be logged with params as:

SELECT DISTINCT role FROM User WHERE status = "Active"

To escape whitespace symbols such as \f\n\r\t\v in params, use the escapeParams option (false by default), this will allow you to output multiline strings more concisely (all your logs will be on one line).

prisma.$on("query", (e) => {
  console.log(formatQuery(e.query, e.params, { escapeParams: true }));
});

And then, they will be displayed like this:

SELECT `Post`.`id` FROM `Post` WHERE `Post`.`title` = "first\nsecond"