# default-values

> Frequent default values

Latest version **1.0.2** (published 2023-05-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install default-values
pnpm add default-values
yarn add default-values
bun add default-values
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.2 |
| Published | 2023-05-06 |
| First published | 2023-04-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 6.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Sergey Rozhkov |
| Maintainers | rozhkov |
| Keywords | empty, freeze, react, react native, stable-references, object, callback, function, array, default-values |

## Links

- npm: https://www.npmjs.com/package/default-values
- Repository: https://github.com/rozhkovs/default-values
- Homepage: https://github.com/rozhkovs/default-values#readme
- Issues: https://github.com/rozhkovs/default-values/issues
- npm.io page: https://npm.io/package/default-values

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.0.2 (latest) — 2023-05-06
- 1.0.1 — 2023-04-24

## README

[LICENSE]: https://github.com/rozhkovs/default-values/blob/HEAD/LICENSE
[AUTHOR]: https://github.com/rozhkovs

# 🫡 Default Values 🫡
<p>
  <a href="https://github.com/rozhkovs/default-values/blob/HEAD/LICENSE">
    <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="Default Values is released under the MIT license." />
  </a>
  <a href="https://github.com/rozhkovs/default-values/actions/workflows/testing.yml">
    <img src="https://github.com/rozhkovs/default-values/actions/workflows/testing.yml/badge.svg" alt="Default values passed the testing" />
  </a>
  <a href="https://www.npmjs.com/package/default-values">
    <img src="https://img.shields.io/npm/v/default-values?color=brightgreen&label=npm%20package" alt="Current npm package version." />
  </a>
</p>

This library aims to provide the most necessary default values. Stop creating variables all over the code!

## Installation
For **npm**
```shell
npm install default-values
```
For **yarn**
```shell
yarn add default-values
```

## Includes
- empty array: 'EMPTY_ARRAY' or 'E_ARR';
- empty object: 'EMPTY_OBJECT' or 'E_OBJ';
- empty callback: 'EMPTY_CALLBACK' or 'E_CB';

## What's the problem?
We all use some default values. And we can do it as follows:
```typescript
const myValue = someValue ?? {}; // {} - defualt value
// or
myValue ??= []; // [] - default value
// or ...
```
But sometimes we need to have a stable reference to the default value for some tasks. Let's look at the following React component.
```tsx
const ParentComponent = () => {
  // ...
  const list = listOrNull ?? [];
  return <MemoHeavyList list={list} />
}
```
If the variable 'listOrNull' is null, then each time the Parent Component function is called, the variable 'list' will have a new reference to an empty array, which will cause the 'MemoHeavyList' component rerender.

We can solve this problem as follows:
```tsx
import {EMPTY_ARRAY} from 'default-values'

const ParentComponent = () => {
  // ...
  const list = listOrNull ?? EMPTY_ARRAY; // EMPTY_ARRAY instead of [];
  return <MemoHeavyList list={list} />
}
```
For such cases, the library provides various typical variables that can be used as default values.

## 👨‍💻 Author
[Sergey Rozhkov][AUTHOR]

## 🎯 Was it helpful?

Do you like it and find it helpful? You can help this project in the following way:
- ⭐ Put the star.
- 💡 Suggest your ideas.
- 😉 Open a founded issue.

## 📄 License

Default Values is MIT licensed, as found in the [LICENSE] file.

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