JSTests/ChakraCore/test/es6/ES6Species-apis.js

//-------------------------------------------------------------------------------------------------------
// Copyright (C) Microsoft. All rights reserved.
// Licensed under the MIT license. See LICENSE.txt file in the project root for full license information.
//-------------------------------------------------------------------------------------------------------

// ES6 Species Built-In APIs tests -- verifies the shape and basic behavior of the built-in [@@species] property

WScript.LoadScriptFile("..\\UnitTestFramework\\UnitTestFramework.js");

function checkSpeciesAccessorDescriptor(name, o, p)
{
    var desc = Object.getOwnPropertyDescriptor(o, p);

    var msg = "Property " + p.toString();

    assert.isTrue(!!desc, msg + "not found; there is no descriptor");

    assert.areEqual(false, desc.enumerable, msg + " enumerable");
    assert.areEqual(true, desc.configurable, msg + " configurable");
    assert.areEqual("function", typeof desc.get, name + "[@@species] is an accessor property that has getter");
    assert.areEqual("get [Symbol.species]", desc.get.name,
        name + "[@@species] is an accessor property whose getter function has the 'name' property 'get [Symbol.species]'");
    assert.areEqual(undefined, desc.set, msg + " set");
}

function getTypedArrayConstructor(o)
{
    return o.prototype.__proto__.constructor;
}

function verifyHasNotSpecies(o)
{
    assert.isFalse(o.hasOwnProperty(Symbol.species), o + " should not have [@@species] defined");
    assert.areEqual(undefined, o[Symbol.species], o + " should have [@@species] that returns 'this'");
}

var tests = [
    {
        name: "Built-in global objects that do not have [@@species] property",
        body: function () {
            verifyHasNotSpecies(Boolean);
            verifyHasNotSpecies(Date);
            verifyHasNotSpecies(Function);
            verifyHasNotSpecies(Math);
            verifyHasNotSpecies(Number);
            verifyHasNotSpecies(Object);
            verifyHasNotSpecies(Proxy);
            verifyHasNotSpecies(Reflect);
            verifyHasNotSpecies(String);
            verifyHasNotSpecies(Symbol);
            verifyHasNotSpecies(WeakMap);
            verifyHasNotSpecies(WeakSet);
        }
    },
    {
        name: "Array should have [@@species] property",
        body: function () {
            assert.isTrue(Array.hasOwnProperty(Symbol.species), "Array should have [@@species] defined");
            assert.areEqual(Array, Array[Symbol.species], "Array should have [@@species] that returns 'this'");
            checkSpeciesAccessorDescriptor("Array", Array, Symbol.species);
        }
    },
    {
        name: "Subclasses inherit [@@species] property from their super classes",
        body: function () {
            class MyArray extends Array {}
            assert.isFalse(MyArray.hasOwnProperty(Symbol.species), "Array subclass should not have [@@species] defined implicitly");
            assert.areEqual(MyArray, MyArray[Symbol.species], "Array subclass should have [@@species] that returns 'this'");

            class MyClass {}
            class MySubClass extends MyClass {}
            assert.areEqual(undefined, MyClass[Symbol.species], "MyClass[@@species] should be undefined");
            assert.areEqual(undefined, MySubClass[Symbol.species], "MySubClass[@@species] should be undefined");
        }
    },
    {
        name: "ArrayBuffer should have [@@species] property",
        body: function () {
            assert.isTrue(ArrayBuffer.hasOwnProperty(Symbol.species), "ArrayBuffer should have [@@species] defined");
            assert.areEqual(ArrayBuffer, ArrayBuffer[Symbol.species], "ArrayBuffer should have [@@species] that returns 'this'");
            checkSpeciesAccessorDescriptor("ArrayBuffer", ArrayBuffer, Symbol.species);
        }
    },
    {
        name: "Map should have [@@species] property",
        body: function () {
            assert.isTrue(Map.hasOwnProperty(Symbol.species), "Map should have [@@species] defined");
            assert.areEqual(Map, Map[Symbol.species], "Map should have [@@species] that returns 'this'");
            checkSpeciesAccessorDescriptor("Map", Map, Symbol.species);
        }
    },
    {
        name: "Promise should have [@@species] property",
        body: function () {
            assert.isTrue(Promise.hasOwnProperty(Symbol.species), "Promise should have [@@species] defined");
            assert.areEqual(Promise, Promise[Symbol.species], "Promise should have [@@species] that returns 'this'");
            checkSpeciesAccessorDescriptor("Promise", Promise, Symbol.species);
        }
    },
    {
        name: "RegExp should have [@@species] property",
        body: function () {
            assert.isTrue(RegExp.hasOwnProperty(Symbol.species), "RegExp should have [@@species] defined");
            assert.areEqual(RegExp, RegExp[Symbol.species], "RegExp should have [@@species] that returns 'this'");
            checkSpeciesAccessorDescriptor("RegExp", RegExp, Symbol.species);
        }
    },
    {
        name: "Set should have [@@species] property",
        body: function () {
            assert.isTrue(Set.hasOwnProperty(Symbol.species), "Set should have [@@species] defined");
            assert.areEqual(Set, Set[Symbol.species], "Set should have [@@species] that returns 'this'");
            checkSpeciesAccessorDescriptor("Set", Set, Symbol.species);
        }
    },
    {
        name: "Int8Array should inherit [@@species] property from %TypedArray%",
        body: function () {
            let TypedArray = getTypedArrayConstructor(Int8Array);
            assert.isTrue(TypedArray.hasOwnProperty(Symbol.species), "%TypedArray% should have [@@species] defined");
            checkSpeciesAccessorDescriptor("TypedArray", TypedArray, Symbol.species);

            assert.isFalse(Int8Array.hasOwnProperty(Symbol.species), "Int8Array should not have [@@species] defined");
            assert.areEqual(Int8Array, Int8Array[Symbol.species], "Int8Array should have [@@species] that returns 'this'");
        }
    },
    {
        name: "Uint8Array should inherit [@@species] property from %TypedArray%",
        body: function () {
            let TypedArray = getTypedArrayConstructor(Uint8Array);
            assert.isTrue(TypedArray.hasOwnProperty(Symbol.species), "%TypedArray% should have [@@species] defined");
            checkSpeciesAccessorDescriptor("TypedArray", TypedArray, Symbol.species);

            assert.isFalse(Uint8Array.hasOwnProperty(Symbol.species), "Uint8Array should not have [@@species] defined");
            assert.areEqual(Uint8Array, Uint8Array[Symbol.species], "Uint8Array should have [@@species] that returns 'this'");
        }
    },
    {
        name: "Uint8ClampedArray should inherit [@@species] property from %TypedArray%",
        body: function () {
            let TypedArray = getTypedArrayConstructor(Uint8ClampedArray);
            assert.isTrue(TypedArray.hasOwnProperty(Symbol.species), "%TypedArray% should have [@@species] defined");
            checkSpeciesAccessorDescriptor("TypedArray", TypedArray, Symbol.species);

            assert.isFalse(Uint8ClampedArray.hasOwnProperty(Symbol.species), "Uint8ClampedArray should not have [@@species] defined");
            assert.areEqual(Uint8ClampedArray, Uint8ClampedArray[Symbol.species], "Uint8ClampedArray should have [@@species] that returns 'this'");
        }
    },
    {
        name: "Int16Array should inherit [@@species] property from %TypedArray%",
        body: function () {
            let TypedArray = getTypedArrayConstructor(Int16Array);
            assert.isTrue(TypedArray.hasOwnProperty(Symbol.species), "%TypedArray% should have [@@species] defined");
            checkSpeciesAccessorDescriptor("TypedArray", TypedArray, Symbol.species);

            assert.isFalse(Int16Array.hasOwnProperty(Symbol.species), "Int16Array should not have [@@species] defined");
            assert.areEqual(Int16Array, Int16Array[Symbol.species], "Int16Array should have [@@species] that returns 'this'");
        }
    },
    {
        name: "Uint16Array should inherit [@@species] property from %TypedArray%",
        body: function () {
            let TypedArray = getTypedArrayConstructor(Uint16Array);
            assert.isTrue(TypedArray.hasOwnProperty(Symbol.species), "%TypedArray% should have [@@species] defined");
            checkSpeciesAccessorDescriptor("TypedArray", TypedArray, Symbol.species);

            assert.isFalse(Uint16Array.hasOwnProperty(Symbol.species), "Uint16Array should not have [@@species] defined");
            assert.areEqual(Uint16Array, Uint16Array[Symbol.species], "Uint16Array should have [@@species] that returns 'this'");
        }
    },
    {
        name: "Int32Array should inherit [@@species] property from %TypedArray%",
        body: function () {
            let TypedArray = getTypedArrayConstructor(Int32Array);
            assert.isTrue(TypedArray.hasOwnProperty(Symbol.species), "%TypedArray% should have [@@species] defined");
            checkSpeciesAccessorDescriptor("TypedArray", TypedArray, Symbol.species);

            assert.isFalse(Int32Array.hasOwnProperty(Symbol.species), "Int32Array should not have [@@species] defined");
            assert.areEqual(Int32Array, Int32Array[Symbol.species], "Int32Array should have [@@species] that returns 'this'");
        }
    },
    {
        name: "Uint32Array should inherit [@@species] property from %TypedArray%",
        body: function () {
            let TypedArray = getTypedArrayConstructor(Uint32Array);
            assert.isTrue(TypedArray.hasOwnProperty(Symbol.species), "%TypedArray% should have [@@species] defined");
            checkSpeciesAccessorDescriptor("TypedArray", TypedArray, Symbol.species);

            assert.isFalse(Uint32Array.hasOwnProperty(Symbol.species), "Uint32Array should not have [@@species] defined");
            assert.areEqual(Uint32Array, Uint32Array[Symbol.species], "Uint32Array should have [@@species] that returns 'this'");
        }
    },
    {
        name: "Float32Array should inherit [@@species] property from %TypedArray%",
        body: function () {
            let TypedArray = getTypedArrayConstructor(Float32Array);
            assert.isTrue(TypedArray.hasOwnProperty(Symbol.species), "%TypedArray% should have [@@species] defined");
            checkSpeciesAccessorDescriptor("TypedArray", TypedArray, Symbol.species);

            assert.isFalse(Float32Array.hasOwnProperty(Symbol.species), "Float32Array should not have [@@species] defined");
            assert.areEqual(Float32Array, Float32Array[Symbol.species], "Float32Array should have [@@species] that returns 'this'");
        }
    },
    {
        name: "Float64Array should inherit [@@species] property from %TypedArray%",
        body: function () {
            let TypedArray = getTypedArrayConstructor(Float64Array);
            assert.isTrue(TypedArray.hasOwnProperty(Symbol.species), "%TypedArray% should have [@@species] defined");
            checkSpeciesAccessorDescriptor("TypedArray", TypedArray, Symbol.species);

            assert.isFalse(Float64Array.hasOwnProperty(Symbol.species), "Float64Array should not have [@@species] defined");
            assert.areEqual(Float64Array, Float64Array[Symbol.species], "Float64Array should have [@@species] that returns 'this'");
        }
    },
];

testRunner.runTests(tests, { verbose: WScript.Arguments[0] != "summary" });