Object.keysLength stage 2 proposal

README.md

@@ -181,6 +181,7 @@ structuredClone(new Set([1, 2, 3])); // => new Set([1, 2, 3])
       - [`String.dedent`](#stringdedent)
       - [`Symbol` predicates](#symbol-predicates)
       - [`Symbol.customMatcher` for extractors](#symbolcustommatcher-for-extractors)
+      - [`Object.keysLength`](#objectkeyslength)
     - [Stage 1 proposals](#stage-1-proposals)
       - [`.of` and `.from` methods on collection constructors](#of-and-from-methods-on-collection-constructors)
       - [`Array` filtering](#array-filtering)
@@ -2991,6 +2992,23 @@ core-js/proposals/pattern-extractors
 core-js(-pure)/full/symbol/custom-matcher
 ```
 
+##### [`Object.keysLength`](https://github.com/tc39/proposal-object-keys-length)[⬆](#index)
+Module [`esnext.object.keys-length`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.object.keys-length.js).
+```ts
+class Object {
+  static keysLength(obj: Object): number;
+}
+```
+[*CommonJS entry points:*](#commonjs-api)
+```
+core-js/proposals/object-keys-length
+core-js(-pure)/full/object/keys-length
+```
+*Examples*:
+```js
+Object.keysLength({ a: 1, b: 2 }); // => 2
+```
+
 #### Stage 1 proposals[⬆](#index)
 [*CommonJS entry points:*](#commonjs-api)
 ```

docs/web/docs/features/proposals/object-keys-length.md

@@ -0,0 +1,24 @@
+# Object.keysLength
+[Specification](https://tc39.es/proposal-object-keys-length/)\
+[Proposal repo](https://github.com/tc39/proposal-object-keys-length)
+
+## Modules
+[`esnext.object.keys-length`](https://github.com/zloirock/core-js/blob/v4/packages/core-js/modules/esnext.object.keys-length.js)
+
+## Built-ins signatures
+```ts
+class Object {
+  static keysLength(obj: Object): number;
+}
+```
+
+## [Entry points]({docs-version}/docs/usage#h-entry-points)
+```plaintext
+core-js/proposals/object-keys-length
+core-js(-pure)/full/object/keys-length
+```
+
+## Examples
+```js
+Object.keysLength({ a: 1, b: 2 }); // => 2
+```

docs/web/docs/menu.json

@@ -307,6 +307,10 @@
               {
                 "title": "Symbol.customMatcher for extractors",
                 "url": "{docs-version}/docs/features/proposals/symbol-custommatcher-for-extractors"
+              },
+              {
+                "title": "Object.keysLength",
+                "url": "{docs-version}/docs/features/proposals/object-keys-length"
               }
             ]
           },

packages/core-js-compat/src/data.mjs

@@ -2461,6 +2461,8 @@ export const data = {
   },
   'esnext.number.clamp': {
   },
+  'esnext.object.keys-length': {
+  },
   'esnext.promise.all-keyed': {
   },
   'esnext.promise.all-settled-keyed': {

packages/core-js/modules/esnext.object.keys-length.js

@@ -0,0 +1,12 @@
+'use strict';
+var $ = require('../internals/export');
+var getBuiltInStaticMethod = require('../internals/get-built-in-static-method');
+var toObject = require('../internals/to-object');
+
+// `Object.keysLength` method
+// https://github.com/tc39/proposal-object-keys-length
+$({ target: 'Object', stat: true, forced: true }, {
+  keysLength: function keysLength(O) {
+    return getBuiltInStaticMethod('Object', 'keys')(toObject(O)).length;
+  },
+});

scripts/build-entries/entries-definitions.mjs

@@ -1848,6 +1848,12 @@ export const features = {
     namespace: 'Object',
     name: 'keys',
   },
+  'object/keys-length': {
+    modules: ['esnext.object.keys-length'],
+    template: $static,
+    namespace: 'Object',
+    name: 'keysLength',
+  },
   'object/lookup-getter': {
     modules: ['es.object.lookup-getter'],
     template: $uncurried,
@@ -3546,6 +3552,13 @@ export const proposals = {
       'es.object.get-own-property-descriptors',
     ],
   },
+  'object-keys-length': {
+    link: 'https://github.com/tc39/proposal-object-keys-length',
+    stage: 2,
+    modules: [
+      'esnext.object.keys-length',
+    ],
+  },
   'object-values-entries': {
     link: 'https://github.com/tc39/proposal-object-values-entries',
     stage: 4,

tests/babel-plugin/fixtures/entry-global/import-full-chrome-135-v4.0/output.mjs

@@ -46,6 +46,7 @@ import "core-js/modules/esnext.iterator.zip-keyed";
 import "core-js/modules/esnext.map.from";
 import "core-js/modules/esnext.map.of";
 import "core-js/modules/esnext.number.clamp";
+import "core-js/modules/esnext.object.keys-length";
 import "core-js/modules/esnext.promise.all-keyed";
 import "core-js/modules/esnext.promise.all-settled-keyed";
 import "core-js/modules/esnext.set.from";

tests/babel-plugin/fixtures/entry-global/import-full-chrome-135-v4.999/output.mjs

@@ -46,6 +46,7 @@ import "core-js/modules/esnext.iterator.zip-keyed";
 import "core-js/modules/esnext.map.from";
 import "core-js/modules/esnext.map.of";
 import "core-js/modules/esnext.number.clamp";
+import "core-js/modules/esnext.object.keys-length";
 import "core-js/modules/esnext.promise.all-keyed";
 import "core-js/modules/esnext.promise.all-settled-keyed";
 import "core-js/modules/esnext.set.from";

tests/babel-plugin/fixtures/entry-global/import-full-ie11-v4.0/output.mjs

@@ -315,6 +315,7 @@ import "core-js/modules/esnext.iterator.zip-keyed";
 import "core-js/modules/esnext.map.from";
 import "core-js/modules/esnext.map.of";
 import "core-js/modules/esnext.number.clamp";
+import "core-js/modules/esnext.object.keys-length";
 import "core-js/modules/esnext.promise.all-keyed";
 import "core-js/modules/esnext.promise.all-settled-keyed";
 import "core-js/modules/esnext.set.from";

tests/babel-plugin/fixtures/entry-global/import-full-ie11-v4.999/output.mjs

@@ -315,6 +315,7 @@ import "core-js/modules/esnext.iterator.zip-keyed";
 import "core-js/modules/esnext.map.from";
 import "core-js/modules/esnext.map.of";
 import "core-js/modules/esnext.number.clamp";
+import "core-js/modules/esnext.object.keys-length";
 import "core-js/modules/esnext.promise.all-keyed";
 import "core-js/modules/esnext.promise.all-settled-keyed";
 import "core-js/modules/esnext.set.from";

tests/babel-plugin/fixtures/entry-global/require-full-chrome-135-v4.0/output.mjs

@@ -46,6 +46,7 @@ import "core-js/modules/esnext.iterator.zip-keyed";
 import "core-js/modules/esnext.map.from";
 import "core-js/modules/esnext.map.of";
 import "core-js/modules/esnext.number.clamp";
+import "core-js/modules/esnext.object.keys-length";
 import "core-js/modules/esnext.promise.all-keyed";
 import "core-js/modules/esnext.promise.all-settled-keyed";
 import "core-js/modules/esnext.set.from";

tests/babel-plugin/fixtures/entry-global/require-full-chrome-135-v4.999/output.mjs

@@ -46,6 +46,7 @@ import "core-js/modules/esnext.iterator.zip-keyed";
 import "core-js/modules/esnext.map.from";
 import "core-js/modules/esnext.map.of";
 import "core-js/modules/esnext.number.clamp";
+import "core-js/modules/esnext.object.keys-length";
 import "core-js/modules/esnext.promise.all-keyed";
 import "core-js/modules/esnext.promise.all-settled-keyed";
 import "core-js/modules/esnext.set.from";

tests/babel-plugin/fixtures/entry-global/require-full-ie11-v4.0/output.mjs

@@ -315,6 +315,7 @@ import "core-js/modules/esnext.iterator.zip-keyed";
 import "core-js/modules/esnext.map.from";
 import "core-js/modules/esnext.map.of";
 import "core-js/modules/esnext.number.clamp";
+import "core-js/modules/esnext.object.keys-length";
 import "core-js/modules/esnext.promise.all-keyed";
 import "core-js/modules/esnext.promise.all-settled-keyed";
 import "core-js/modules/esnext.set.from";

tests/babel-plugin/fixtures/entry-global/require-full-ie11-v4.999/output.mjs

@@ -315,6 +315,7 @@ import "core-js/modules/esnext.iterator.zip-keyed";
 import "core-js/modules/esnext.map.from";
 import "core-js/modules/esnext.map.of";
 import "core-js/modules/esnext.number.clamp";
+import "core-js/modules/esnext.object.keys-length";
 import "core-js/modules/esnext.promise.all-keyed";
 import "core-js/modules/esnext.promise.all-settled-keyed";
 import "core-js/modules/esnext.set.from";

tests/compat/tests.js

@@ -1909,6 +1909,9 @@ GLOBAL.tests = {
   'esnext.number.clamp': function () {
     return Number.prototype.clamp;
   },
+  'esnext.object.keys-length': function () {
+    return Object.keysLength;
+  },
   'esnext.promise.all-keyed': function () {
     return Promise.allKeyed;
   },

tests/entries/unit.mjs

@@ -753,6 +753,7 @@ for (PATH of ['@core-js/pure', 'core-js']) {
     ok(load(NS, 'map/of')([1, 2], [3, 4]) instanceof Map);
     ok(load(NS, 'number/clamp')(6, 2, 4) === 4);
     ok(load(NS, 'number/prototype/clamp').call(6, 2, 4) === 4);
+    ok(typeof load(NS, 'object/keys-length') == 'function');
     ok(load(NS, 'promise/all-keyed')({}) instanceof Promise);
     ok(load(NS, 'promise/all-settled-keyed')({}) instanceof Promise);
     ok(load(NS, 'set/from')([1, 2, 3, 2, 1]) instanceof Set);
@@ -830,6 +831,7 @@ for (PATH of ['@core-js/pure', 'core-js']) {
   load('proposals/math-sum');
   load('proposals/object-from-entries');
   load('proposals/object-getownpropertydescriptors');
+  load('proposals/object-keys-length');
   load('proposals/object-values-entries');
   load('proposals/pattern-matching');
   load('proposals/promise-all-keyed');

tests/eslint/eslint.config.js

@@ -1293,7 +1293,7 @@ const forbidCompletelyNonExistentBuiltIns = {
     'clamp',
   ] }],
   'es/no-nonstandard-object-properties': [ERROR, { allow: [
-    // empty
+    'keysLength',
   ] }],
   'es/no-nonstandard-promise-properties': [ERROR, { allow: [
     'allKeyed',

tests/unit-global/esnext.object.keys-length.js

@@ -0,0 +1,13 @@
+QUnit.test('Object.keysLength', assert => {
+  const { keysLength } = Object;
+  assert.isFunction(keysLength);
+  assert.name(keysLength, 'keysLength');
+  assert.arity(keysLength, 1);
+  assert.looksNative(keysLength);
+  assert.nonEnumerable(Object, 'keysLength');
+
+  assert.same(keysLength({ a: 1, b: 2 }), 2, 'Basic functionality');
+  assert.same(keysLength({}), 0, 'Empty object');
+  assert.throws(() => keysLength(null), TypeError);
+  assert.throws(() => keysLength(), TypeError);
+});

tests/unit-pure/esnext.object.keys-length.js

@@ -0,0 +1,12 @@
+import keysLength from '@core-js/pure/full/object/keys-length';
+
+QUnit.test('Object.keysLength', assert => {
+  assert.isFunction(keysLength);
+  assert.name(keysLength, 'keysLength');
+  assert.arity(keysLength, 1);
+
+  assert.same(keysLength({ a: 1, b: 2 }), 2, 'Basic functionality');
+  assert.same(keysLength({}), 0, 'Empty object');
+  assert.throws(() => keysLength(null), TypeError);
+  assert.throws(() => keysLength(), TypeError);
+});