https://github.com/ehmicky/redefine-property
Better `Object.defineProperty()`
https://github.com/ehmicky/redefine-property
browser configurable define define-property defineproperty descriptor descriptors enumerability enumerable get-set javascript library nodejs object properties property readonly reflect typescript writable
Last synced: 3 months ago
JSON representation
Better `Object.defineProperty()`
- Host: GitHub
- URL: https://github.com/ehmicky/redefine-property
- Owner: ehmicky
- License: mit
- Created: 2022-11-25T13:29:58.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-05-25T23:03:22.000Z (5 months ago)
- Last Synced: 2025-07-06T20:07:31.538Z (3 months ago)
- Topics: browser, configurable, define, define-property, defineproperty, descriptor, descriptors, enumerability, enumerable, get-set, javascript, library, nodejs, object, properties, property, readonly, reflect, typescript, writable
- Language: JavaScript
- Homepage:
- Size: 3.9 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/redefine-property)
[](https://unpkg.com/redefine-property?module)
[](/src/main.d.ts)
[](https://codecov.io/gh/ehmicky/redefine-property)
[](https://bundlephobia.com/package/redefine-property)
[](https://fosstodon.org/@ehmicky)
[](https://medium.com/@ehmicky)
Better `Object.defineProperty()`.
# Features
This is identical to
[`Object.defineProperty()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty)
except:
- The [default value](#default-values) of `enumerable`, `writable` and
`configurable` is `true`
- If the property already exists, its descriptors are
[used as default](#keep-previous-descriptor), even if the property is
[inherited](#keep-inherited-descriptor)
- Invalid arguments throw with a [clear error message](#better-validation)
- Otherwise, this [never throws](#exception-safety)
# Example
```js
import redefineProperty from 'redefine-property'
const object = redefineProperty({}, 'prop', { value: 0, enumerable: false })
console.log(Object.getOwnPropertyDescriptor(object, 'prop'))
// {
// value: 0,
// enumerable: false,
// writable: true,
// configurable: true,
// }
```
# Install
```bash
npm install redefine-property
```
This package works in both Node.js >=18.18.0 and
[browsers](https://raw.githubusercontent.com/ehmicky/dev-tasks/main/src/browserslist).
This is an ES module. It must be loaded using
[an `import` or `import()` statement](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c),
not `require()`. If TypeScript is used, it must be configured to
[output ES modules](https://www.typescriptlang.org/docs/handbook/esm-node.html),
not CommonJS.
# API
## redefineProperty(value, key, descriptor)
`value` `object`\
`key` `string | symbol | number`\
`descriptor` `PropertyDescriptor`\
_Return value_: `value`
Like
[`Object.defineProperty(...)`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty)
but with some [additional features](#features).
# Usage
## Default values
```js
const object = redefineProperty({}, 'prop', { value: 0 })
console.log(Object.getOwnPropertyDescriptor(object, 'prop'))
// {
// value: 0,
// enumerable: true,
// writable: true,
// configurable: true,
// }
const otherObject = Object.defineProperty({}, 'prop', { value: 0 })
console.log(Object.getOwnPropertyDescriptor(otherObject, 'prop'))
// {
// value: 0,
// enumerable: false,
// writable: false,
// configurable: false,
// }
```
## Keep previous descriptor
```js
const object = redefineProperty({}, 'prop', {
value: 0,
enumerable: false,
writable: true,
configurable: true,
})
redefineProperty(object, 'prop', { value: 1, configurable: false })
console.log(Object.getOwnPropertyDescriptor(object, 'prop'))
// {
// value: 1,
// enumerable: false,
// writable: true,
// configurable: false,
// }
```
## Keep inherited descriptor
```js
class CustomError extends Error {}
redefineProperty(CustomError.prototype, 'name', {
value: 'CustomError',
enumerable: false,
})
const error = new CustomError('')
redefineProperty(error, 'name', { value: 'ExampleError' })
console.log(Object.getOwnPropertyDescriptor(error, 'name'))
// {
// value: 'ExampleError',
// enumerable: false,
// writable: true,
// configurable: true,
// }
const otherError = new CustomError('')
Object.defineProperty(otherError, 'name', { value: 'ExampleError' })
console.log(Object.getOwnPropertyDescriptor(otherError, 'name'))
// {
// value: 'ExampleError',
// enumerable: false,
// writable: false,
// configurable: false,
// }
```
## Better validation
```js
Object.defineProperty({}, true, { value: 0 }) // This does not throw
redefineProperty({}, true, { value: 0 }) // This throws
```
## Exception safety
```js
const object = new Proxy(
{},
{
defineProperty: () => {
throw new Error('example')
},
},
)
redefineProperty(object, 'prop', { value: 1 }) // This does not throw
Object.defineProperty(object, 'prop', { value: 1 }) // This throws
```
# Support
For any question, _don't hesitate_ to [submit an issue on GitHub](../../issues).
Everyone is welcome regardless of personal background. We enforce a
[Code of conduct](CODE_OF_CONDUCT.md) in order to promote a positive and
inclusive environment.
# Contributing
This project was made with ❤️. The simplest way to give back is by starring and
sharing it online.
If the documentation is unclear or has a typo, please click on the page's `Edit`
button (pencil icon) and suggest a correction.
If you would like to help us fix a bug or add a new feature, please check our
[guidelines](CONTRIBUTING.md). Pull requests are welcome!