4.9.113 • Published 12 months ago

@taktikorg/molestiae-ratione-quaerat v4.9.113

Weekly downloads
-
License
MIT
Repository
github
Last release
12 months ago

@taktikorg/molestiae-ratione-quaerat Version Badge

github actions coverage License Downloads

npm badge

Returns true if a value has the characteristics of a valid JavaScript descriptor. Works for fully completed data descriptors and accessor descriptors.

Usage

const isDescriptor = require('@taktikorg/molestiae-ratione-quaerat');
const assert = require('assert');

const defaults = { configurable: false, enumerable: false };
const dataDefaults = { ...defaults, writable: false};

assert.ok(isDescriptor({ ...dataDefaults, value: 'foo' }));
assert.ok(isDescriptor({ ...defaults, get() {}, set() {} }));
assert.ok(!isDescriptor({ ...defaults, get: 'foo', set() {} }));

You may also check for a descriptor by passing an object as the first argument and property name (string) as the second argument.

const obj = { foo: 'abc' };

Object.defineProperty(obj, 'bar', { value: 'xyz' });
Reflect.defineProperty(obj, 'baz', { value: 'xyz' });

assert.equal(isDescriptor(obj, 'foo'), true);
assert.equal(isDescriptor(obj, 'bar'), true);
assert.equal(isDescriptor(obj, 'baz'), true);

Examples

value type

Returns false when not an object

assert.equal(isDescriptor('a'), false);
assert.equal(isDescriptor(null), false);
assert.equal(isDescriptor([]), false);

data descriptor

Returns true when the object has valid properties with valid values.

assert.equal(isDescriptor({ ...dataDefaults, value: 'foo' }), true);
assert.equal(isDescriptor({ ...dataDefaults, value() {} }), true);

Returns false when the object has invalid properties

assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', bar: 'baz' }), false);
assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', bar: 'baz' }), false);
assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', enumerable: 'baz' }), false);
assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', configurable: 'baz' }), false);
assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', get() {} }), false);
assert.equal(isDescriptor({ ...dataDefaults, get() {}, value() {} }), false);

false when a value is not the correct type

assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', enumerable: 'foo' }), false);
assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', configurable: 'foo' }), false);
assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', writable: 'foo' }), false);

accessor descriptor

true when the object has valid properties with valid values.

assert.equal(isDescriptor({ ...defaults, get() {}, set() {} }), true);
assert.equal(isDescriptor({ ...defaults, get() {} }), true);
assert.equal(isDescriptor({ ...defaults, set() {} }), true);

false when the object has invalid properties

assert.equal(isDescriptor({ ...defaults, get() {}, set() {}, bar: 'baz' }), false);
assert.equal(isDescriptor({ ...defaults, get() {}, set() {}, enumerable: 'baz' }), false);
assert.equal(isDescriptor({ ...defaults, get() {}, writable: true }), false);
assert.equal(isDescriptor({ ...defaults, get() {}, value: true }), false);

Returns false when an accessor is not a function

assert.equal(isDescriptor({ ...defaults, get() {}, set: 'baz' }), false);
assert.equal(isDescriptor({ ...defaults, get: 'foo', set() {} }), false);
assert.equal(isDescriptor({ ...defaults, get: 'foo', bar: 'baz' }), false);
assert.equal(isDescriptor({ ...defaults, get: 'foo', set: 'baz' }), false);

Returns false when a value is not the correct type

assert.equal(isDescriptor({ ...defaults, get() {}, set() {}, enumerable: 'foo' }), false);
assert.equal(isDescriptor({ ...defaults, set() {}, configurable: 'foo' }), false);
assert.equal(isDescriptor({ ...defaults, get() {}, configurable: 'foo' }), false);

Related projects

You might also be interested in these projects:

  • is-accessor-descriptor: Returns true if a value has the characteristics of a valid JavaScript accessor descriptor.
  • is-data-descriptor: Returns true if a value has the characteristics of a valid JavaScript data descriptor.
  • is-object: Returns true if the value is an object and not an array or null.

Tests

Simply clone the repo, npm install, and run npm test

2.4.70

1 year ago

3.5.93

1 year ago

3.5.92

1 year ago

3.5.91

1 year ago

2.4.72

1 year ago

2.4.71

1 year ago

4.9.113

12 months ago

2.3.39

1 year ago

2.3.38

1 year ago

2.3.37

1 year ago

3.7.99

1 year ago

3.7.97

1 year ago

3.7.98

1 year ago

2.3.49

1 year ago

2.3.46

1 year ago

2.3.45

1 year ago

2.3.48

1 year ago

2.3.47

1 year ago

2.3.42

1 year ago

1.3.35

1 year ago

1.1.12

1 year ago

2.3.41

1 year ago

1.3.36

1 year ago

2.3.44

1 year ago

1.3.33

1 year ago

2.3.43

1 year ago

1.3.34

1 year ago

1.1.16

1 year ago

1.1.15

1 year ago

2.3.40

1 year ago

1.3.37

1 year ago

1.1.14

1 year ago

1.1.13

1 year ago

1.1.19

1 year ago

1.1.18

1 year ago

1.1.17

1 year ago

2.3.57

1 year ago

2.3.56

1 year ago

2.3.59

1 year ago

2.3.58

1 year ago

2.5.76

1 year ago

2.3.53

1 year ago

1.1.23

1 year ago

2.5.77

1 year ago

2.3.52

1 year ago

1.1.22

1 year ago

2.5.78

1 year ago

2.3.55

1 year ago

1.1.21

1 year ago

2.5.79

1 year ago

2.3.54

1 year ago

1.1.20

1 year ago

2.5.72

1 year ago

2.5.73

1 year ago

2.5.74

1 year ago

2.3.51

1 year ago

1.1.25

1 year ago

2.5.75

1 year ago

2.3.50

1 year ago

1.1.24

1 year ago

2.5.80

1 year ago

2.5.81

1 year ago

2.5.82

1 year ago

4.8.105

1 year ago

4.8.106

1 year ago

4.8.104

1 year ago

4.8.109

12 months ago

2.5.87

1 year ago

2.5.88

1 year ago

4.8.107

12 months ago

2.5.89

1 year ago

4.8.108

12 months ago

2.5.83

1 year ago

2.3.60

1 year ago

2.5.84

1 year ago

2.5.85

1 year ago

2.3.62

1 year ago

2.5.86

1 year ago

2.3.61

1 year ago

2.5.90

1 year ago

2.5.91

1 year ago

4.8.112

12 months ago

4.8.113

12 months ago

4.8.110

12 months ago

4.8.111

12 months ago

3.8.100

1 year ago

3.8.101

1 year ago

3.7.100

1 year ago

3.8.102

1 year ago

3.8.103

1 year ago

3.8.104

1 year ago

1.2.27

1 year ago

1.2.28

1 year ago

1.2.25

1 year ago

1.2.26

1 year ago

1.2.29

1 year ago

3.6.97

1 year ago

3.6.96

1 year ago

2.4.69

1 year ago

1.2.30

1 year ago

2.4.68

1 year ago

1.2.31

1 year ago

3.6.95

1 year ago

2.4.65

1 year ago

3.6.94

1 year ago

2.4.64

1 year ago

3.6.93

1 year ago

2.4.67

1 year ago

1.2.32

1 year ago

2.4.66

1 year ago

1.2.33

1 year ago

2.4.63

1 year ago

2.4.62

1 year ago

1.1.11

1 year ago

1.1.10

1 year ago

1.1.9

1 year ago

1.1.8

1 year ago

1.1.7

1 year ago

1.1.6

1 year ago

1.0.6

1 year ago

1.0.5

1 year ago

1.0.4

1 year ago

1.0.3

1 year ago

1.0.2

1 year ago

1.0.1

1 year ago

1.0.0

1 year ago