# ember-truth-helpers

> Ember Truth Helpers

Latest version **5.0.0** (published 2025-09-12) · MIT license · 0 weekly downloads

## Install

```sh
npm install ember-truth-helpers
pnpm add ember-truth-helpers
yarn add ember-truth-helpers
bun add ember-truth-helpers
```

## Health

**Score 40/100 (D)** — status: stable.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 5.0.0 |
| Published | 2025-09-12 |
| First published | 2015-01-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 31.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 702 |
| Author | James Murphy |
| Maintainers | rwjblue, jmurphyau, nlfurniss, sergeastapov |
| Keywords | ember-addon |

## Links

- npm: https://www.npmjs.com/package/ember-truth-helpers
- Repository: https://github.com/jmurphyau/ember-truth-helpers
- Homepage: https://github.com/jmurphyau/ember-truth-helpers#readme
- Issues: https://github.com/jmurphyau/ember-truth-helpers/issues
- npm.io page: https://npm.io/package/ember-truth-helpers

## Dependencies (1)

- [@embroider/addon-shim](https://npm.io/package/@embroider/addon-shim.md) ^1.8.9

## Recent versions

- 5.0.0 (latest) — 2025-09-12
- 4.0.0-beta.0 (beta) — 2023-08-09
- 4.0.3 — 2023-09-11
- 4.0.2 — 2023-09-08
- 4.0.1 — 2023-09-06
- 4.0.0 — 2023-09-02
- 3.1.1 — 2022-07-28
- 3.1.0 — 2022-07-26
- 3.0.0 — 2020-10-09
- 2.1.0 — 2018-08-20
- 2.0.0 — 2017-10-14
- 1.3.0 — 2016-12-30
- 1.2.0 — 2015-10-23
- 1.1.0 — 2015-08-10
- 1.0.0 — 2015-07-06
- … 5 more at https://npm.io/package/ember-truth-helpers/versions

## README

# Ember Truth Helpers [![CI](https://github.com/jmurphyau/ember-truth-helpers/actions/workflows/ci.yml/badge.svg)](https://github.com/jmurphyau/ember-truth-helpers/actions/workflows/ci.yml)

HTMLBars template helpers for additional truth logic in `if` and `unless` statements.

## Compatibility

- Ember.js v4.8 or above
- Embroider or ember-auto-import >= 2 (this is [v2 addon](https://emberjs.github.io/rfcs/0507-embroider-v2-package-format.html))

## Installation

```
ember install ember-truth-helpers
```

## Usage

Helper   | JavaScript                                      | HTMLBars                | Import                                            | Variable argument count allowed|
---------|-------------------------------------------------|-------------------------|-------------------------------------------------- |--------------------------------|
eq       | `if (a === b)`                                  | `{{if (eq a b)}}`       | import { eq } from 'ember-truth-helpers';         |No                              |
not-eq   | `if (a !== b)`                                  | `{{if (not-eq a b)}}`   | import { notEq } from 'ember-truth-helpers';      |No                              |
not      | `if (!a)`                                       | `{{if (not a)}}`        | import { not } from 'ember-truth-helpers';        |Yes                             |
and      | `if (a && b)`                                   | `{{if (and a b)}}`      | import { and } from 'ember-truth-helpers';        |Yes                             |
or       | <code>if (a &#124;&#124; b)</code>              | `{{if (or a b)}}`       | import { or } from 'ember-truth-helpers';         |Yes                             |
xor      | <code>if (a !== b)</code>                       | `{{if (xor a b)}}`      | import { xor } from 'ember-truth-helpers';        |No                              |
gt       | `if (a > b)`                                    | `{{if (gt a b)}}`       | import { gt } from 'ember-truth-helpers';         |No                              |
gte      | `if (a >= b)`                                   | `{{if (gte a b)}}`      | import { gte } from 'ember-truth-helpers';        |No                              |
lt       | `if (a < b)`                                    | `{{if (lt a b)}}`       | import { lt } from 'ember-truth-helpers';         |No                              |
lte      | `if (a <= b)`                                   | `{{if (lte a b)}}`      | import { eq } from 'ember-truth-helpers';         |No                              |
is-array | `if (Ember.isArray(a))`                         | `{{if (is-array a)}}`   | import { isArray } from 'ember-truth-helpers';    |Yes                             |
is-empty | `if (Ember.isEmpty(a))`                         | `{{if (is-empty a)}}`   | import { isEmpty } from 'ember-truth-helpers';    |No                              |
is-equal | `if (Ember.isEqual(a, b))`                      | `{{if (is-equal a b)}}` | import { isEqual } from 'ember-truth-helpers';    |No                              |

## API

### is-equal

`is-equal` uses [`Ember.isEqual`](https://api.emberjs.com/ember/3.14/functions/@ember%2Futils/isEqual) helper to evaluate equality of two values.
 `eq` should be sufficient for most applications. `is-equal` is necessary when trying to compare a complex object to
 a primitive value.

## Other Helpers

* [ember-get-helper](https://github.com/jmurphyau/ember-get-helper)
* [ember-composable-helpers](https://github.com/DockYard/ember-composable-helpers)

## Usage with Glint

`ember-truth-helpers` is a glint enabled addon. Add this to your
`types/global.d.ts` file:

```ts
import '@glint/environment-ember-loose';

import type EmberTruthRegistry from 'ember-truth-helpers/template-registry';

declare module '@glint/environment-ember-loose/registry' {
  export default interface Registry extends EmberTruthRegistry, /* other addon registries */ {
    // local entries
  }
}
```

For the entire guide, please refer to [Using
Addons](https://typed-ember.gitbook.io/glint/environments/ember/using-addons#using-glint-enabled-addons)
section on the glint handbook.

Types are made available through package.json `exports` field. In order for TS
to recognize this (beginning from TS 4.7), you must set
[`moduleResolution`](https://www.typescriptlang.org/tsconfig#moduleResolution)
to `node16` or `nodenext`.

## Usage in Single File Components

For usage in `gts` or `gjs` files, all helpers are exported from the index:

```gts
import { or } from 'ember-truth-helpers';

<template>
  {{#if (or @admin @user)}}
    Admin Controls are going here
  {{/if}}
</template>
```

## Contributing

See the [Contributing](CONTRIBUTING.md) guide for details.

## License

This project is licensed under the [MIT License](LICENSE.md).

---
_Source: https://npm.io/package/ember-truth-helpers · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._