add self

Author: zloirock

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

@@ -2520,6 +2520,15 @@ export const data = {
     node: '12.0', // '11.0',
     safari: '12.1',
   },
+  'web.self': {
+    chrome: '86',
+    // https://github.com/denoland/deno/issues/15765
+    // deno: false,
+    // fails in early Chrome-based Edge
+    // edge: '12',
+    firefox: '31',
+    safari: '10',
+  },
   'web.set-immediate': {
     bun: '0.1.7',
     ie: '10',

packages/core-js-compat/src/modules-by-versions.mjs

@@ -160,5 +160,6 @@ export default {
   3.26: [
     'esnext.string.is-well-formed',
     'esnext.string.to-well-formed',
+    'web.self',
   ],
 };

packages/core-js-pure/override/modules/web.self.js

@@ -0,0 +1,8 @@
+var $ = require('../internals/export');
+var global = require('../internals/global');
+
+// `self` getter
+// https://html.spec.whatwg.org/multipage/window-object.html#dom-self
+$({ global: true, forced: global.self !== global }, {
+  self: global
+});

packages/core-js/actual/self.js

@@ -0,0 +1,3 @@
+var parent = require('../stable/self');
+
+module.exports = parent;

packages/core-js/full/self.js

@@ -0,0 +1,3 @@
+var parent = require('../actual/self');
+
+module.exports = parent;

packages/core-js/modules/web.self.js

@@ -0,0 +1,41 @@
+'use strict';
+var $ = require('../internals/export');
+var global = require('../internals/global');
+var defineBuiltInAccessor = require('../internals/define-built-in-accessor');
+var DESCRIPTORS = require('../internals/descriptors');
+
+var $TypeError = TypeError;
+// eslint-disable-next-line es/no-object-defineproperty -- safe
+var defineProperty = Object.defineProperty;
+var INCORRECT_VALUE = global.self !== global;
+
+// `self` getter
+// https://html.spec.whatwg.org/multipage/window-object.html#dom-self
+try {
+  if (DESCRIPTORS) {
+    // eslint-disable-next-line es/no-object-getownpropertydescriptor -- safe
+    var descriptor = Object.getOwnPropertyDescriptor(global, 'self');
+    // some engines have `self`, but with incorrect descriptor
+    // https://github.com/denoland/deno/issues/15765
+    if (INCORRECT_VALUE || !descriptor || !descriptor.get || !descriptor.enumerable) {
+      defineBuiltInAccessor(global, 'self', {
+        get: function self() {
+          return global;
+        },
+        set: function self(value) {
+          if (this !== global) throw $TypeError('Illegal invocation');
+          defineProperty(global, 'self', {
+            value: value,
+            writable: true,
+            configurable: true,
+            enumerable: true
+          });
+        },
+        configurable: true,
+        enumerable: true
+      });
+    }
+  } else $({ global: true, simple: true, forced: INCORRECT_VALUE }, {
+    self: global
+  });
+} catch (error) { /* empty */ }

packages/core-js/stable/self.js

@@ -0,0 +1,4 @@
+require('../modules/web.self');
+var path = require('../internals/path');
+
+module.exports = path.self;

packages/core-js/web/index.js

@@ -7,6 +7,7 @@ require('../modules/web.dom-exception.stack');
 require('../modules/web.dom-exception.to-string-tag');
 require('../modules/web.immediate');
 require('../modules/web.queue-microtask');
+require('../modules/web.self');
 require('../modules/web.structured-clone');
 require('../modules/web.timers');
 require('../modules/web.url');

tests/commonjs.mjs

@@ -584,6 +584,7 @@ for (PATH of ['core-js-pure', 'core-js']) {
     ok(typeof load(NS, 'dom-collections').iterator == 'function');
     ok(typeof load(NS, 'dom-collections/for-each') == 'function');
     ok(typeof load(NS, 'dom-collections/iterator') == 'function');
+    ok(load(NS, 'self').Math === Math);
     ok(typeof load(NS, 'set-timeout') == 'function');
     ok(typeof load(NS, 'set-interval') == 'function');
     ok(typeof load(NS, 'set-immediate') == 'function');

tests/compat/tests.js

@@ -1853,6 +1853,13 @@ GLOBAL.tests = {
   'web.queue-microtask': function () {
     return Object.getOwnPropertyDescriptor(GLOBAL, 'queueMicrotask').value;
   },
+  'web.self': function () {
+    // eslint-disable-next-line no-restricted-globals -- safe
+    if (self !== GLOBAL) return false;
+    if (!DESCRIPTORS_SUPPORT) return true;
+    var descriptor = Object.getOwnPropertyDescriptor(GLOBAL, 'self');
+    return descriptor.get && descriptor.enumerable;
+  },
   'web.set-immediate': IMMEDIATE,
   'web.set-interval': TIMERS,
   'web.set-timeout': TIMERS,

tests/pure/web.self.js

@@ -0,0 +1,6 @@
+import self from 'core-js-pure/stable/self';
+
+QUnit.test('self', assert => {
+  assert.same(self, Object(self), 'is object');
+  assert.same(self.Math, Math, 'contains globals');
+});

tests/tests/web.self.js

@@ -0,0 +1,14 @@
+/* eslint-disable no-restricted-globals -- safe */
+import { DESCRIPTORS } from '../helpers/constants';
+
+QUnit.test('self', assert => {
+  assert.same(self, Object(self), 'is object');
+  assert.same(self.Math, Math, 'contains globals');
+  if (DESCRIPTORS) {
+    const descriptor = Object.getOwnPropertyDescriptor(self, 'self');
+    // can't be properly defined (non-configurable) in some ancient engines like PhantomJS
+    // assert.isFunction(descriptor.get, 'a getter');
+    // assert.true(descriptor.configurable, 'configurable');
+    assert.true(descriptor.enumerable, 'enumerable');
+  }
+});