# @mangroves/field-mask

> Field mask helper

Latest version **0.1.1** (published 2021-07-25) · MIT license · 0 weekly downloads

## Install

```sh
npm install @mangroves/field-mask
pnpm add @mangroves/field-mask
yarn add @mangroves/field-mask
bun add @mangroves/field-mask
```

## Health

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

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.1 |
| Published | 2021-07-25 |
| First published | 2021-06-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 24.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | mangroves-fe |
| Maintainers | chuchencheng |
| Keywords | field mask, update mask |

## Links

- npm: https://www.npmjs.com/package/@mangroves/field-mask
- Repository: https://github.com/mangroves-fe/field-mask
- Homepage: https://github.com/mangroves-fe/field-mask#readme
- Issues: https://github.com/mangroves-fe/field-mask/issues
- npm.io page: https://npm.io/package/@mangroves/field-mask

## Recent versions

- 0.1.1 (latest) — 2021-07-25
- 0.1.0 — 2021-06-21

## README

# field-mask

[![codecov](https://codecov.io/gh/mangroves-fe/field-mask/branch/main/graph/badge.svg?token=PLW5YE8FTZ)](https://codecov.io/gh/mangroves-fe/field-mask)
[![Node.js CI](https://github.com/mangroves-fe/field-mask/actions/workflows/node.js.yml/badge.svg?branch=main)](https://github.com/mangroves-fe/field-mask/actions/workflows/node.js.yml)

FieldMask hepler which offers some utils to get field mask or update object.

A mangroves-fe project.

# Install

## yarn

```bash
yarn add @mangroves/field-mask
```

## import

```typescript
import { getMaskFromObject } from '@mangroves/field-mask'
// Or
import * as FieldMask from '@mangroves/field-mask'
```

# Usage

## getMaskFromObject

Mainly in front-end scenarios. To get the mask by an object.

```typescript
const object = {
  a: {
    b: 1,
    c: 2,
  },
  d: 3,
}
const mask = FieldMask.getMaskFromObject(object)
console.log(mask) // ['a.b', 'a.c', 'd']
```

## getObjectByMask

To get partial object by the mask.

```typescript
const object = {
  a: {
    b: 1,
    c: 2,
  },
  d: 3,
}
const partial = FieldMask.getObjectByMask(object, ['a.b'])
console.log(partial) // { a: { b: 1 } }
```

## updateObjectByMask

To partial update an object.

```typescript
const object = {
  a: {
    b: 1,
    c: 2,
  },
  d: 3,
}

const update = {
  a: {
    b: 4,
  },
}

const updateCount = FieldMask.updateObjectByMask(object, update, ['a.b'])
console.log(updateCount) // 1
console.log(object.a.b) // 4
```

## filterMaskByObject

To filter mask according to the object.

```typescript
const object = {
  a: {
    b: 1,
    c: 2,
  },
  d: 3,
}

const filteredMask = FieldMask.filterMaskByObject(['a.b', 'a.c', 'a.d', 'notExist'], object)
console.log(filteredMask) // ['a.b', 'a.c']
```

## filterMaskByMask

To filter mask according to an allowed mask list.

```typescript
const mask = [
  'a.b',
  'c.d', // exact match
  'x.y.w', // not allowed
  'k', // not exist
]
const allowedMask = ['a', 'c.d', 'x.y.z']
const filteredMask = FieldMask.filterMaskByMask(mask, allowedMask)
console.log(filteredMask) // ['a.b', 'c.d']
```

# Reference

- [FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask)

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