# is-subset

> Check if an object is contained within another one

Latest version **0.1.1** (published 2015-04-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install is-subset
pnpm add is-subset
yarn add is-subset
bun add is-subset
```

## Health

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

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.1 |
| Published | 2015-04-29 |
| First published | 2015-04-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 27 |
| Author | Tomek Wiszniewski |
| Maintainers | tomekwi |
| Keywords | contains, contain, object, superset, deep-equal, equal |

## Links

- npm: https://www.npmjs.com/package/is-subset
- Repository: git@github.com:studio-b12/is-subset
- Homepage: https://github.com/studio-b12/is-subset
- Issues: https://github.com/studio-b12/is-subset/issues
- npm.io page: https://npm.io/package/is-subset

## Recent versions

- 0.1.1 (latest) — 2015-04-29
- 0.1.0 — 2015-04-29

## README

[![Coveralls – test coverage
](https://img.shields.io/coveralls/studio-b12/is-subset.svg?style=flat-square)
](https://coveralls.io/r/studio-b12/is-subset)
 [![Travis – build status
](https://img.shields.io/travis/studio-b12/is-subset/master.svg?style=flat-square)
](https://travis-ci.org/studio-b12/is-subset)
 [![David – status of dependencies
](https://img.shields.io/david/studio-b12/is-subset.svg?style=flat-square)
](https://david-dm.org/studio-b12/is-subset)
 [![Code style: airbnb
](https://img.shields.io/badge/code%20style-airbnb-blue.svg?style=flat-square)
](https://github.com/airbnb/javascript)




is-subset
=========

**Check if an object is contained within another one.**




Installation
------------

```sh
$ npm install is-subset
```




Usage
-----

1) Import the module:

```js
import isSubset from 'is-subset/module';

// …or:
var isSubset = require('is-subset');
```

2) These are true:

```js
isSubset(
  {a: 1, b: 2},
  {a: 1}
);

isSubset(
  {a: 1, b: {c: 3, d: 4}, e: 5},
  {a: 1, b: {c: 3}}
);

isSubset(
  {a: 1, bcd: [1, 2, 3]},
  {a: 1, bcd: [1, 2]}
);
```

…and these are false:

```js
isSubset(
  {a: 1},
  {a: 2}
);

isSubset(
  {a: 1},
  {a: 1, b: 2}
);

isSubset(
  {a: 1, bcd: [1, 2, 3]},
  {a: 1, bcd: [1, 3]}
);
```

See the [specs][] for more info.

[specs]:  ./test.js




API
===

###  *isSubset*(*superset*, *subset*)  ###

Check if an object is contained within another object.

Returns `true` if:
- all enumerable keys of *subset* are also enumerable in *superset*, and
- every value assigned to an enumerable key of *subset* strictly equals the value assigned to the same key of *superset* – or is a subset of it.

**Parameters:**
- `Object` *superset*
- `Object` *subset*

**Return value:**
- `Boolean`




License
-------

[MIT][] © [Studio B12 GmbH][]

[MIT]:  ./License.md
[Studio B12 GmbH]:  https://github.com/studio-b12

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