{"id":16208455,"url":"https://github.com/ehmicky/redefine-property","last_synced_at":"2025-07-27T15:07:42.653Z","repository":{"id":63776117,"uuid":"570556761","full_name":"ehmicky/redefine-property","owner":"ehmicky","description":"Better `Object.defineProperty()`","archived":false,"fork":false,"pushed_at":"2025-05-25T23:03:22.000Z","size":4093,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-06T20:07:31.538Z","etag":null,"topics":["browser","configurable","define","define-property","defineproperty","descriptor","descriptors","enumerability","enumerable","get-set","javascript","library","nodejs","object","properties","property","readonly","reflect","typescript","writable"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ehmicky.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-11-25T13:29:58.000Z","updated_at":"2025-05-25T23:03:27.000Z","dependencies_parsed_at":"2023-02-07T12:16:36.808Z","dependency_job_id":"b480511a-e412-42d1-99d9-35ccf2815b2e","html_url":"https://github.com/ehmicky/redefine-property","commit_stats":{"total_commits":137,"total_committers":3,"mean_commits":"45.666666666666664","dds":0.03649635036496346,"last_synced_commit":"60b73af9e214ed4fa89fa9e68f105b7acf5bbb29"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":"ehmicky/template-javascript","purl":"pkg:github/ehmicky/redefine-property","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fredefine-property","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fredefine-property/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fredefine-property/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fredefine-property/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ehmicky","download_url":"https://codeload.github.com/ehmicky/redefine-property/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fredefine-property/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267375872,"owners_count":24077291,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-27T02:00:11.917Z","response_time":82,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser","configurable","define","define-property","defineproperty","descriptor","descriptors","enumerability","enumerable","get-set","javascript","library","nodejs","object","properties","property","readonly","reflect","typescript","writable"],"created_at":"2024-10-10T10:17:01.395Z","updated_at":"2025-07-27T15:07:42.647Z","avatar_url":"https://github.com/ehmicky.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Node](https://img.shields.io/badge/-Node.js-808080?logo=node.js\u0026colorA=404040\u0026logoColor=66cc33)](https://www.npmjs.com/package/redefine-property)\n[![Browsers](https://img.shields.io/badge/-Browsers-808080?logo=firefox\u0026colorA=404040)](https://unpkg.com/redefine-property?module)\n[![TypeScript](https://img.shields.io/badge/-Typed-808080?logo=typescript\u0026colorA=404040\u0026logoColor=0096ff)](/src/main.d.ts)\n[![Codecov](https://img.shields.io/badge/-Tested%20100%25-808080?logo=codecov\u0026colorA=404040)](https://codecov.io/gh/ehmicky/redefine-property)\n[![Minified size](https://img.shields.io/bundlephobia/minzip/redefine-property?label\u0026colorA=404040\u0026colorB=808080\u0026logo=webpack)](https://bundlephobia.com/package/redefine-property)\n[![Mastodon](https://img.shields.io/badge/-Mastodon-808080.svg?logo=mastodon\u0026colorA=404040\u0026logoColor=9590F9)](https://fosstodon.org/@ehmicky)\n[![Medium](https://img.shields.io/badge/-Medium-808080.svg?logo=medium\u0026colorA=404040)](https://medium.com/@ehmicky)\n\nBetter `Object.defineProperty()`.\n\n# Features\n\nThis is identical to\n[`Object.defineProperty()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty)\nexcept:\n\n- The [default value](#default-values) of `enumerable`, `writable` and\n  `configurable` is `true`\n- If the property already exists, its descriptors are\n  [used as default](#keep-previous-descriptor), even if the property is\n  [inherited](#keep-inherited-descriptor)\n- Invalid arguments throw with a [clear error message](#better-validation)\n- Otherwise, this [never throws](#exception-safety)\n\n# Example\n\n```js\nimport redefineProperty from 'redefine-property'\n\nconst object = redefineProperty({}, 'prop', { value: 0, enumerable: false })\nconsole.log(Object.getOwnPropertyDescriptor(object, 'prop'))\n// {\n//   value: 0,\n//   enumerable: false,\n//   writable: true,\n//   configurable: true,\n// }\n```\n\n# Install\n\n```bash\nnpm install redefine-property\n```\n\nThis package works in both Node.js \u003e=18.18.0 and\n[browsers](https://raw.githubusercontent.com/ehmicky/dev-tasks/main/src/browserslist).\n\nThis is an ES module. It must be loaded using\n[an `import` or `import()` statement](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c),\nnot `require()`. If TypeScript is used, it must be configured to\n[output ES modules](https://www.typescriptlang.org/docs/handbook/esm-node.html),\nnot CommonJS.\n\n# API\n\n## redefineProperty(value, key, descriptor)\n\n`value` `object`\\\n`key` `string | symbol | number`\\\n`descriptor` `PropertyDescriptor`\\\n_Return value_: `value`\n\nLike\n[`Object.defineProperty(...)`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty)\nbut with some [additional features](#features).\n\n# Usage\n\n## Default values\n\n\u003c!-- eslint-disable fp/no-mutating-methods --\u003e\n\n```js\nconst object = redefineProperty({}, 'prop', { value: 0 })\nconsole.log(Object.getOwnPropertyDescriptor(object, 'prop'))\n// {\n//   value: 0,\n//   enumerable: true,\n//   writable: true,\n//   configurable: true,\n// }\n\nconst otherObject = Object.defineProperty({}, 'prop', { value: 0 })\nconsole.log(Object.getOwnPropertyDescriptor(otherObject, 'prop'))\n// {\n//   value: 0,\n//   enumerable: false,\n//   writable: false,\n//   configurable: false,\n// }\n```\n\n## Keep previous descriptor\n\n```js\nconst object = redefineProperty({}, 'prop', {\n  value: 0,\n  enumerable: false,\n  writable: true,\n  configurable: true,\n})\nredefineProperty(object, 'prop', { value: 1, configurable: false })\nconsole.log(Object.getOwnPropertyDescriptor(object, 'prop'))\n// {\n//   value: 1,\n//   enumerable: false,\n//   writable: true,\n//   configurable: false,\n// }\n```\n\n## Keep inherited descriptor\n\n\u003c!-- eslint-disable fp/no-class, fp/no-mutating-methods --\u003e\n\n```js\nclass CustomError extends Error {}\nredefineProperty(CustomError.prototype, 'name', {\n  value: 'CustomError',\n  enumerable: false,\n})\n\nconst error = new CustomError('')\nredefineProperty(error, 'name', { value: 'ExampleError' })\nconsole.log(Object.getOwnPropertyDescriptor(error, 'name'))\n// {\n//   value: 'ExampleError',\n//   enumerable: false,\n//   writable: true,\n//   configurable: true,\n// }\n\nconst otherError = new CustomError('')\nObject.defineProperty(otherError, 'name', { value: 'ExampleError' })\nconsole.log(Object.getOwnPropertyDescriptor(otherError, 'name'))\n// {\n//   value: 'ExampleError',\n//   enumerable: false,\n//   writable: false,\n//   configurable: false,\n// }\n```\n\n## Better validation\n\n\u003c!-- eslint-disable fp/no-mutating-methods --\u003e\n\n```js\nObject.defineProperty({}, true, { value: 0 }) // This does not throw\nredefineProperty({}, true, { value: 0 }) // This throws\n```\n\n## Exception safety\n\n\u003c!-- eslint-disable fp/no-proxy, fp/no-mutating-methods --\u003e\n\n```js\nconst object = new Proxy(\n  {},\n  {\n    defineProperty: () =\u003e {\n      throw new Error('example')\n    },\n  },\n)\n\nredefineProperty(object, 'prop', { value: 1 }) // This does not throw\nObject.defineProperty(object, 'prop', { value: 1 }) // This throws\n```\n\n# Support\n\nFor any question, _don't hesitate_ to [submit an issue on GitHub](../../issues).\n\nEveryone is welcome regardless of personal background. We enforce a\n[Code of conduct](CODE_OF_CONDUCT.md) in order to promote a positive and\ninclusive environment.\n\n# Contributing\n\nThis project was made with ❤️. The simplest way to give back is by starring and\nsharing it online.\n\nIf the documentation is unclear or has a typo, please click on the page's `Edit`\nbutton (pencil icon) and suggest a correction.\n\nIf you would like to help us fix a bug or add a new feature, please check our\n[guidelines](CONTRIBUTING.md). Pull requests are welcome!\n\n\u003c!-- Thanks go to our wonderful contributors: --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START --\u003e\n\u003c!-- prettier-ignore --\u003e\n\u003c!--\n\u003ctable\u003e\u003ctr\u003e\u003ctd align=\"center\"\u003e\u003ca href=\"https://fosstodon.org/@ehmicky\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/8136211?v=4\" width=\"100px;\" alt=\"ehmicky\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eehmicky\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/ehmicky/redefine-property/commits?author=ehmicky\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"#design-ehmicky\" title=\"Design\"\u003e🎨\u003c/a\u003e \u003ca href=\"#ideas-ehmicky\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"https://github.com/ehmicky/redefine-property/commits?author=ehmicky\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\u003c/tr\u003e\u003c/table\u003e\n --\u003e\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehmicky%2Fredefine-property","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fehmicky%2Fredefine-property","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehmicky%2Fredefine-property/lists"}