Mastering String Formatting in JavaScript with sprintf()

• sprintf() provides precise control over string formatting-padding, alignment, decimal precision, and type conversion-that template literals and concatenation cannot match.
• sprintf.js is a lightweight, open-source library that faithfully implements the standard sprintf behavior in JavaScript.
• Two functions:sprintf() for variadic arguments, vsprintf() for array arguments.
• Placeholders use the format %[argument_index$][flags][width][.precision]type-supporting 15+ type specifiers including strings, integers, floats, booleans, hex, and octal.
• Named placeholders improve readability when working with objects: "User %(name)s is %(age)d years old."
• Argument reordering allows you to reference arguments in any order: "%2$s %1$s" outputs “Hello World”.

const name = "Alice";
const age = 30;
const message = "My name is " + name + " and I am " + age + " years old.";

const message = `My name is ${name} and I am ${age} years old.`;

const message = sprintf("My name is %s and I am %d years old.", name, age);

• Padding (leading zeros, fixed widths)
• Decimal precision (rounding to 2 decimal places)
• Type conversion (hex, octal, binary, scientific notation)
• Argument reordering (using the same argument multiple times or changing order)
• Internationalization (separating templates from data)
• Reading from configuration (loading format strings from external sources)

• Faithful implementation-adheres closely to standard sprintf behavior
• Lightweight-minimal footprint, no dependencies
• Open source-permissive license for use in any project
• Node.js and browser support-works in modern JavaScript environments
• TypeScript support-includes type definitions

npm install @playfulsparkle/sprintf-js

yarn add @playfulsparkle/sprintf-js

<script src="https://cdn.jsdelivr.net/npm/@playfulsparkle/sprintf-js/dist/sprintf.min.js"></script>

import { sprintf } from '@playfulsparkle/sprintf-js';
const name = "Charlie";
const score = 95;
const message = sprintf("Student %s achieved a score of %d.", name, score);
// Output: "Student Charlie achieved a score of 95."
const pi = Math.PI;
const formattedPi = sprintf("Pi is approximately %.2f.", pi);
// Output: "Pi is approximately 3.14."

import { vsprintf } from '@playfulsparkle/sprintf-js';
const data = ["David", 88, "Science"];
const message = vsprintf("Student %s scored %d in %s.", data);
// Output: "Student David scored 88 in Science."

%[argument_index$][flags][width][.precision]type

sprintf("%10s", "Test") // Output: " Test" (right-aligned, width 10)
sprintf("%-10s", "Test") // Output: "Test " (left-aligned, width 10)

sprintf("%.2f", 3.14159) // Output: "3.14"
sprintf("%.5s", "JavaScript") // Output: "JavaS"

sprintf("%2$s %1$s", "World", "Hello") // Output: "Hello World"

import { sprintf } from '@playfulsparkle/sprintf-js';
const user = { name: "Jane", age: 25 };
const message = sprintf("User %(name)s is %(age)d years old.", user);
// Output: "User Jane is 25 years old."

import { sprintf } from '@playfulsparkle/sprintf-js';
const timestamp = new Date().toISOString();
const level = "ERROR";
const message = "Failed to connect to database.";
const log = sprintf("[%s] [%s] %s", timestamp, level, message);
// Output: "[2026-08-02T12:30:45.000Z] [ERROR] Failed to connect to database."

import { sprintf } from '@playfulsparkle/sprintf-js';
const userId = 123;
const baseUrl = "https://api.example.com/users/%d";
const apiUrl = sprintf(baseUrl, userId);
// Output: "https://api.example.com/users/123"

import { sprintf } from '@playfulsparkle/sprintf-js';
const rows = [
 ["Alice", 95],
 ["Bob", 87],
 ["Charlie", 102]
];
for (const [name, score] of rows) {
 console.log(sprintf("%-10s %3d", name, score));
}
// Output:
// Alice 95
// Bob 87
// Charlie 102

import { sprintf } from '@playfulsparkle/sprintf-js';
const price = 49.99;
const discount = 0.15;
const finalPrice = price * (1 - discount);
const message = sprintf("Original: $%.2f | Discount: %.0f%% | Final: $%.2f",
 price, discount * 100, finalPrice);
// Output: "Original: $49.99 | Discount: 15% | Final: $42.49"

import { sprintf } from '@playfulsparkle/sprintf-js';
const color = 0xFF00FF;
console.log(sprintf("Hex: %X", color)); // "Hex: FF00FF"
console.log(sprintf("Binary: %b", 42)); // "Binary: 101010"

import { sprintf } from '@playfulsparkle/sprintf-js';
const firstName = "John";
const lastName = "Doe";
console.log(sprintf("Last name: %2$s, First name: %1$s", firstName, lastName));
// Output: "Last name: Doe, First name: John"

import { sprintf } from '@playfulsparkle/sprintf-js';
// Example: template loaded from a translation file or database
const emailTemplate = "Dear %s,\n\nThank you for your order #%d.\n\nRegards,\n%s";
const customerName = "Jane Smith";
const orderId = 12345;
const teamName = "Support Team";
const email = sprintf(emailTemplate, customerName, orderId, teamName);

• All actively supported versions (v16+)

• Chrome (all modern versions)
• Firefox (all modern versions)
• Safari (all modern versions)
• Edge (all modern versions)

npm install @playfulsparkle/sprintf-js

import { sprintf } from '@playfulsparkle/sprintf-js';

const { sprintf } = require('@playfulsparkle/sprintf-js');

sprintf("%s", 123) // "123" (converted to string)
sprintf("%d", "123") // "123" (converted to integer)
sprintf("%s", null) // "null"

1. JavaScript doesn’t have built-in sprintf. Libraries like sprintf.js fill this gap with a familiar, powerful API.
2. sprintf() offers formatting controls-padding, precision, type conversion, and argument reordering-that template literals cannot match.
3. Two functions:sprintf(format, ...args) for variadic arguments and vsprintf(format, args[]) for array arguments.
4. Placeholder syntax is %[argument_index$][flags][width][.precision]type-learn the type specifiers to use the library effectively.
5. Named placeholders improve readability: "User %(name)s is %(age)d years old."
6. Choose the right tool for the job. Template literals work for simple cases; sprintf.js is for complex formatting requirements.