# handlebars-extd > 40+ Handlebars helpers for comparison, string, math, date, HTML, and more. Works in Node.js and the browser. Latest version **1.0.14** (published 2026-03-07) · MIT license · 0 weekly downloads ## Install ```sh npm install handlebars-extd pnpm add handlebars-extd yarn add handlebars-extd bun add handlebars-extd ``` ## Health **Score 60/100 (C)** — status: stable. Positive: has types; esm support; no vulnerabilities; high quality score. Warnings: low downloads. ## Facts | | | |---|---| | Version | 1.0.14 | | Published | 2026-03-07 | | First published | 2021-10-25 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 4 | | Unpacked size | 490.4 KB | | Known vulnerabilities | 0 (+1 in 1 direct dependencies) | | Install scripts | no | | Author | shumatsumonobu | | Maintainers | takuya-motoshima | | Keywords | handlebars, hbs, helpers, template, comparison, string, math, date, html, formatting, typescript | ## Links - npm: https://www.npmjs.com/package/handlebars-extd - Repository: https://github.com/shumatsumonobu/handlebars-extd - Homepage: https://github.com/shumatsumonobu/handlebars-extd#readme - Issues: https://github.com/shumatsumonobu/handlebars-extd/issues - npm.io page: https://npm.io/package/handlebars-extd ## Dependencies (4) - [moment](https://npm.io/package/moment.md) ^2.30.1 - [striptags](https://npm.io/package/striptags.md) ^3.2.0 - [handlebars](https://npm.io/package/handlebars.md) ^4.7.8 - [sprintf-js](https://npm.io/package/sprintf-js.md) ^1.1.3 ## Alternatives - [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) — 303.7K weekly downloads - [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) — 233.7K weekly downloads - [stringify-attributes](https://npm.io/package/stringify-attributes.md) — 58.6K weekly downloads - [mobile-drag-drop](https://npm.io/package/mobile-drag-drop.md) — 46.3K weekly downloads - [@comunica/actor-rdf-parse-html](https://npm.io/package/@comunica/actor-rdf-parse-html.md) — 29.2K weekly downloads ## Recent versions - 1.0.14 (latest) — 2026-03-07 - 1.0.13 — 2025-02-04 - 1.0.12 — 2025-02-04 - 1.0.11 — 2025-01-14 - 1.0.10 — 2024-07-30 - 1.0.9 — 2024-03-01 - 1.0.8 — 2023-07-01 - 1.0.7 — 2023-06-18 - 1.0.6 — 2023-06-13 - 1.0.5 — 2022-12-23 - 1.0.4 — 2022-04-20 - 1.0.3 — 2022-04-19 - 1.0.2 — 2022-01-17 - 1.0.1 — 2022-01-17 - 1.0.0 — 2021-10-25 ## README # handlebars-extd **40+ production-ready Handlebars helpers** for comparison, string manipulation, math, dates, HTML generation, and more. Works in Node.js and the browser. Zero config. Just `import` and go. ```bash npm install handlebars-extd ``` ```js const hbs = require('handlebars-extd'); hbs.compile('{{#if (gt price 100)}}Expensive{{/if}}')({price: 250}); // => "Expensive" hbs.compile('{{formatDate "YYYY/MM/DD" date}}')({date: '2024-01-15T09:30:00Z'}); // => "2024/01/15" hbs.compile('{{uppercase greeting}}')({greeting: 'hello world'}); // => "HELLO WORLD" ``` ## Comparison Helpers ### `eq` / `neq` Strict equality (`===`) and strict inequality (`!==`). ```js hbs.compile('{{eq a b}}')({a: 3, b: 3}); // true hbs.compile('{{eq a b}}')({a: '3', b: 3}); // false (different types) hbs.compile('{{neq a b}}')({a: 4, b: 3}); // true ``` ### `eqw` / `neqw` Loose equality (`==`) and loose inequality (`!=`). Type coercion is applied. ```js hbs.compile('{{eqw a b}}')({a: '3', b: 3}); // true hbs.compile('{{neqw a b}}')({a: '3', b: 3}); // false ``` ### `gt` / `gte` / `lt` / `lte` Greater than, greater than or equal, less than, less than or equal. ```js hbs.compile('{{gt a b}}')({a: 5, b: 3}); // true hbs.compile('{{gte a b}}')({a: 3, b: 3}); // true hbs.compile('{{lt a b}}')({a: 2, b: 3}); // true hbs.compile('{{lte a b}}')({a: 3, b: 3}); // true ``` ### `opr` Generic comparison operator. Supports `==`, `===`, `!=`, `!==`, `<`, `>`, `<=`, `>=`. ```js hbs.compile("{{opr a '===' b}}")({a: '3', b: 3}); // false hbs.compile("{{opr a '==' b}}")({a: '3', b: 3}); // true hbs.compile("{{opr a '<' b}}")({a: 2, b: 3}); // true ``` ### `and` / `or` / `not` Logical operators. `and` and `or` accept any number of arguments. ```js hbs.compile('{{and a b}}')({a: true, b: true}); // true hbs.compile('{{and a b c}}')({a: true, b: true, c: false}); // false hbs.compile('{{or a b}}')({a: false, b: true}); // true hbs.compile('{{not false}}')(); // true ``` ### `empty` / `notEmpty` Checks whether a value is empty. Trims whitespace (including full-width spaces) from strings. Treats empty arrays as empty. ```js hbs.compile('{{empty val}}')({val: []}); // true hbs.compile('{{empty val}}')({val: ''}); // true hbs.compile('{{empty val}}')({val: ' '}); // true hbs.compile('{{notEmpty val}}')({val: 'Hello'}); // true ``` ### `ifx` Ternary conditional, similar to `condition ? trueValue : falseValue`. ```js hbs.compile('{{ifx true a b}}')({a: 'Yes', b: 'No'}); // "Yes" hbs.compile('{{ifx false a b}}')({a: 'Yes', b: 'No'}); // "No" ``` ### `coalesce` Returns the first truthy value from the argument list. Falls back to the last value if none are truthy. ```js hbs.compile('{{coalesce a b c}}')({a: '', b: 'bar', c: 'baz'}); // "bar" hbs.compile("{{coalesce a b 'default'}}")({a: '', b: null}); // "default" ``` ### `includes` Checks whether an array contains a value. Uses strict equality by default. ```js hbs.compile('{{includes list a}}')({list: [1, 2, 3], a: 2}); // true hbs.compile('{{includes list a}}')({list: [1, 2, 3], a: '3'}); // false (strict) hbs.compile('{{includes list a strict}}')({list: [1, 2, 3], a: '3', strict: false}); // true ``` ### `count` Returns the length of an array, or `false` if the value is not an array. ```js hbs.compile('{{count collection}}')({collection: ['a', 'b', 'c']}); // 3 hbs.compile('{{count collection}}')({collection: 'not an array'}); // false ``` ### `regexMatch` Tests whether a string matches a regular expression pattern. ```js hbs.compile("{{regexMatch 'foobar' 'foo'}}")(); // true hbs.compile("{{regexMatch 'foobar' '^foo$'}}")(); // false hbs.compile("{{regexMatch 'Visit Here' 'here' 'i'}}")(); // true (case-insensitive) hbs.compile("{{#if (regexMatch 'foobar' 'foo')}}Match{{/if}}")(); // "Match" ``` ## String Helpers ### `uppercase` / `lowercase` Converts a string to uppercase or lowercase. ```js hbs.compile('{{uppercase str}}')({str: 'hello world'}); // "HELLO WORLD" hbs.compile('{{lowercase str}}')({str: 'Hello World'}); // "hello world" ``` ### `concat` Concatenates any number of strings. ```js hbs.compile("{{concat 'Hello' ' world' '!'}}")(); // "Hello world!" hbs.compile('{{concat a b}}')({a: 'foo', b: 'bar'}); // "foobar" ``` ### `join` Joins the elements of an array with a separator. Defaults to `","`. ```js hbs.compile("{{{join collection ', '}}}")({collection: ['apple', 'banana', 'cherry']}); // "apple, banana, cherry" hbs.compile("{{{join collection '-'}}}")({collection: ['a', 'b', 'c']}); // "a-b-c" ``` ### `split` Splits a string into an array by a separator. Defaults to `","`. ```js hbs.compile("{{split list}}")({list: 'a,b,c'}); // ['a', 'b', 'c'] // Useful with {{#each}}: hbs.compile("")({list: 'a,b,c'}); // "" ``` ### `slice` Extracts a portion of a string. Supports negative indices. ```js hbs.compile('{{slice str 0 4}}')({str: 'Just Wow'}); // "Just" hbs.compile('{{slice str 5}}')({str: 'Just Wow'}); // "Wow" hbs.compile('{{slice str -4}}')({str: 'Just Wow'}); // " Wow" ``` ### `nltobr` Replaces newline characters with `
` tags. Use triple-stache `{{{ }}}` to avoid HTML escaping. ```js hbs.compile('{{{nltobr str}}}')({str: 'Line 1\nLine 2\nLine 3'}); // "Line 1
Line 2
Line 3" ``` ### `sprintf` Formats a string using sprintf-style specifiers. Powered by [sprintf-js](https://github.com/alexei/sprintf.js). ```js hbs.compile("{{sprintf '%s %s!' s1 s2}}")({s1: 'Hello', s2: 'World'}); // "Hello World!" hbs.compile("{{sprintf 'Item count: %d, price: $%.2f' count price}}")({count: 42, price: 9.99}); // "Item count: 42, price: $9.99" // Named arguments: hbs.compile("{{sprintf 'Hello %(name)s' user}}")({user: {name: 'Alice'}}); // "Hello Alice" ``` ## Math Helpers ### `add` / `sub` / `multiply` / `divide` Basic arithmetic. Accepts numbers or numeric strings. ```js hbs.compile('{{add a b}}')({a: 10, b: 5}); // 15 hbs.compile('{{sub a b}}')({a: 10, b: 3}); // 7 hbs.compile('{{multiply a b}}')({a: 5, b: 2}); // 10 hbs.compile('{{divide a b}}')({a: 7, b: 2}); // 3.5 ``` ### `abs` Returns the absolute value. ```js hbs.compile('{{abs a}}')({a: -5.6}); // 5.6 ``` ### `ceil` / `floor` Rounds up (ceiling) or down (floor) to the nearest integer. ```js hbs.compile('{{ceil a}}')({a: 5.1}); // 6 hbs.compile('{{floor a}}')({a: 5.9}); // 5 ``` ## Date Helpers ### `formatDate` Formats a date using [Moment.js](https://momentjs.com/docs/#/displaying/format/) format strings. Uses the current date if none is provided. ```js hbs.compile("{{formatDate 'YYYY/MM/DD' date}}")({date: '2024-01-15T09:30:00Z'}); // "2024/01/15" // With locale: hbs.compile("{{formatDate 'dddd' date 'es'}}")({date: '2024-01-15T09:30:00Z'}); // "lunes" ``` ## HTML Helpers ### `checkedIf` / `selectedIf` Returns `"checked"` or `"selected"` when the condition is truthy, otherwise an empty string. ```js hbs.compile('')({isActive: true}); // '' hbs.compile('')({isDefault: true}); // '' ``` ### `classIf` Returns a CSS class name when the condition is truthy. ```js hbs.compile('
')({isActive: true}); // '
' ``` ### `options` Generates `