Package Exports

@arcjet/sprintf
@arcjet/sprintf/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@arcjet/sprintf) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

`@arcjet/sprintf`

Arcjet platform-independent replacement for util.format.

This package is platform-independent in order to support multiple runtimes in varying environments, such as Edge Runtime, Node.js, Bun, Deno, and Cloudflare Workers.

What is this?

This is an internal utility to help us format log messages. It’s a fork of pinojs/quick-format-unescaped. We chose to fork so that we can maintain as much compatibility as possible while being more restrictive.

When should I use this?

You should not use this but use pinojs/quick-format-unescaped or one of the alternatives instead. This package matches our current needs which are likely different from yours.

Install

This package is ESM only. Install with npm in Node.js:

npm install @arcjet/sprintf

Use

import format from "@arcjet/sprintf";

console.log(format("Hello %s", "world")); // => "Hello world"
console.log(format("1 %i %d", 2, 3.0)); // => "1 2 3"

Substitutions

Substitutions will be made for the following character sequences if the matching argument conforms to the type. For example, "%d" will only be replaced by a number, not a string or object.

Object substitution supports any value that is not undefined.

%d | %f - Replaced if provided with a number.
%i - Replaced if provided with a number after Math.floor is called on it.
%O | %o | %j - Replaced if provided with any value after JSON.stringify is called on it. Objects with circular references will be replaced with [Circular]. Functions will be replaced with the function name or <anonymous> if unnamed.
%s - Replaced if provided with a string.
%% - Replaced by the literal % character.

License

Derivative work based on quick-format-unescaped licensed under MIT © David Mark Clements. Our work is more restrictive while maintaining as much compatibility as possible.