Tests for new API Temporal.TimeZone.p.equals

Author: justingrant

test/built-ins/Temporal/TimeZone/prototype/equals/argument-object.js

@@ -0,0 +1,84 @@
+// Copyright (C) 2023 Justin Grant. All rights reserved.
+// This code is governed by the BSD license found in the LICENSE file.
+
+/*---
+esid: sec-temporal.timezone.prototype.equals
+description: Tests that objects can be compared for equality
+features: [Temporal]
+---*/
+
+class CustomTimeZone extends Temporal.TimeZone {
+  constructor(id) {
+    super("UTC");
+    this._id = id;
+  }
+  get id() {
+    return this._id;
+  }
+}
+
+const objectsEqualUTC = [
+  new Temporal.TimeZone("UTC"),
+  new CustomTimeZone("UTC"),
+  { id: "UTC", getPossibleInstantsFor: null, getOffsetNanosecondsFor: null },
+  new Temporal.ZonedDateTime(0n, "UTC")
+];
+
+const tzUTC = new Temporal.TimeZone("UTC");
+
+for (const object of objectsEqualUTC) {
+  const result = tzUTC.equals(object);
+  assert.sameValue(result, true);
+}
+
+const objectsEqual0000 = [
+  new Temporal.TimeZone("+00:00"),
+  new Temporal.TimeZone("+0000"),
+  new Temporal.TimeZone("+00"),
+  new CustomTimeZone("+00:00"),
+  new CustomTimeZone("+0000"),
+  new CustomTimeZone("+00"),
+  { id: "+00:00", getPossibleInstantsFor: null, getOffsetNanosecondsFor: null },
+  { id: "+0000", getPossibleInstantsFor: null, getOffsetNanosecondsFor: null },
+  { id: "+00", getPossibleInstantsFor: null, getOffsetNanosecondsFor: null },
+  new Temporal.ZonedDateTime(0n, "+00:00"),
+  new Temporal.ZonedDateTime(0n, "+0000"),
+  new Temporal.ZonedDateTime(0n, "+00")
+];
+
+const tz0000 = new Temporal.TimeZone("+00:00");
+
+for (const object of objectsEqual0000) {
+  const result = tz0000.equals(object);
+  assert.sameValue(result, true);
+}
+
+const objectsNotEqual = [
+  new Temporal.TimeZone("+00:00"),
+  new CustomTimeZone("+00:00"),
+  { id: "+00:00", getPossibleInstantsFor: null, getOffsetNanosecondsFor: null },
+  { id: "Etc/Custom", getPossibleInstantsFor: null, getOffsetNanosecondsFor: null },
+  new Temporal.ZonedDateTime(0n, "+00:00")
+];
+
+for (const object of objectsNotEqual) {
+  const result = tzUTC.equals(object);
+  assert.sameValue(result, false);
+}
+
+// Custom object IDs are compared case-sensitively
+const classInstanceCustomId = new CustomTimeZone("Moon/Cheese");
+const classInstanceSameCaseCustomId = new CustomTimeZone("Moon/Cheese");
+const classInstanceDifferentCaseCustomId = new CustomTimeZone("MoOn/CHEESe");
+
+const plainObjectSameCaseCustomId = { id: "Moon/Cheese", getPossibleInstantsFor: null, getOffsetNanosecondsFor: null };
+const plainObjectDifferentCaseCustomId = {
+  id: "MoOn/CHEESe",
+  getPossibleInstantsFor: null,
+  getOffsetNanosecondsFor: null
+};
+
+assert.sameValue(classInstanceCustomId.equals(classInstanceSameCaseCustomId), true);
+assert.sameValue(classInstanceCustomId.equals(classInstanceDifferentCaseCustomId), false);
+assert.sameValue(classInstanceCustomId.equals(plainObjectSameCaseCustomId), true);
+assert.sameValue(classInstanceCustomId.equals(plainObjectDifferentCaseCustomId), false);

test/built-ins/Temporal/TimeZone/prototype/equals/argument-primitive.js

@@ -0,0 +1,33 @@
+// Copyright (C) 2023 Justin Grant. All rights reserved.
+// This code is governed by the BSD license found in the LICENSE file.
+
+/*---
+esid: sec-temporal.timezone.from
+description: Exceptions thrown if a value is passed that converts to an invalid string
+features: [Temporal]
+---*/
+
+const primitives = [
+  undefined,
+  null,
+  true,
+  "string",
+  "local",
+  "Z",
+  "-00:00[UTC]",
+  "+00:01.1",
+  "-01.1",
+  "1994-11-05T08:15:30+25:00",
+  "1994-11-05T13:15:30-25:00",
+  7,
+  4.2,
+  12n
+];
+
+const tzUTC = new Temporal.TimeZone("UTC");
+for (const primitive of primitives) {
+  assert.throws(typeof primitive === "string" ? RangeError : TypeError, () => tzUTC.equals(primitive));
+}
+
+const symbol = Symbol();
+assert.throws(TypeError, () => tzUTC.equals(symbol));

test/built-ins/Temporal/TimeZone/prototype/equals/argument-valid.js

@@ -0,0 +1,45 @@
+// Copyright (C) 2023 Justin Grant. All rights reserved.
+// This code is governed by the BSD license found in the LICENSE file.
+
+/*---
+esid: sec-temporal.timezone.from
+description: Built-in time zones are compared correctly out of valid strings
+features: [Temporal]
+---*/
+
+const validsEqual = [
+  ["+0330", "+03:30"],
+  ["-0650", "-06:50"],
+  ["-08", "-08:00"],
+  ["\u221201:00", "-01:00"],
+  ["\u22120650", "-06:50"],
+  ["\u221208", "-08:00"],
+  ["1994-11-05T08:15:30-05:00", "-05:00"],
+  ["1994-11-05T08:15:30\u221205:00", "-05:00"],
+  ["1994-11-05T13:15:30Z", "UTC"]
+];
+
+for (const [valid, canonical] of validsEqual) {
+  const tzValid = Temporal.TimeZone.from(valid);
+  const tzCanonical = Temporal.TimeZone.from(canonical);
+  assert.sameValue(tzValid.equals(canonical), true);
+  assert.sameValue(tzCanonical.equals(valid), true);
+}
+
+const validsNotEqual = [
+  ["+0330", "+03:31"],
+  ["-0650", "-06:51"],
+  ["-08", "-08:01"],
+  ["\u221201:00", "-01:01"],
+  ["\u22120650", "-06:51"],
+  ["\u221208", "-08:01"],
+  ["1994-11-05T08:15:30-05:00", "-05:01"],
+  ["1994-11-05T08:15:30\u221205:00", "-05:01"]
+];
+
+for (const [valid, canonical] of validsNotEqual) {
+  const tzValid = Temporal.TimeZone.from(valid);
+  const tzCanonical = Temporal.TimeZone.from(canonical);
+  assert.sameValue(tzValid.equals(canonical), false);
+  assert.sameValue(tzCanonical.equals(valid), false);
+}

test/built-ins/Temporal/TimeZone/prototype/equals/branding.js

@@ -0,0 +1,24 @@
+// Copyright (C) 2023 Justin Grant. All rights reserved.
+// This code is governed by the BSD license found in the LICENSE file.
+
+/*---
+esid: sec-temporal.timezone.prototype.equals
+description: Throw a TypeError if the receiver is invalid
+features: [Symbol, Temporal]
+---*/
+
+const equals = Temporal.TimeZone.prototype.equals;
+
+assert.sameValue(typeof equals, "function");
+
+const args = ["UTC"];
+
+assert.throws(TypeError, () => equals.apply(undefined, args), "undefined");
+assert.throws(TypeError, () => equals.apply(null, args), "null");
+assert.throws(TypeError, () => equals.apply(true, args), "true");
+assert.throws(TypeError, () => equals.apply("", args), "empty string");
+assert.throws(TypeError, () => equals.apply(Symbol(), args), "symbol");
+assert.throws(TypeError, () => equals.apply(1, args), "1");
+assert.throws(TypeError, () => equals.apply({}, args), "plain object");
+assert.throws(TypeError, () => equals.apply(Temporal.TimeZone, args), "Temporal.TimeZone");
+assert.throws(TypeError, () => equals.apply(Temporal.TimeZone.prototype, args), "Temporal.TimeZone.prototype");

test/built-ins/Temporal/TimeZone/prototype/equals/builtin.js

@@ -0,0 +1,33 @@
+// Copyright (C) 2023 Justin Grant. All rights reserved.
+// This code is governed by the BSD license found in the LICENSE file.
+
+/*---
+esid: sec-temporal.timezone.prototype.equals
+description: >
+    Tests that Temporal.TimeZone.prototype.equals
+    meets the requirements for built-in objects defined by the
+    introduction of chapter 17 of the ECMAScript Language Specification.
+info: |
+    Built-in functions that are not constructors do not have a "prototype" property unless
+    otherwise specified in the description of a particular function.
+
+    Unless specified otherwise, a built-in object that is callable as a function is a built-in
+    function object with the characteristics described in 10.3. Unless specified otherwise, the
+    [[Extensible]] internal slot of a built-in object initially has the value true.
+
+    Unless otherwise specified every built-in function and every built-in constructor has the
+    Function prototype object [...] as the value of its [[Prototype]] internal slot.
+features: [Temporal]
+---*/
+
+assert.sameValue(Object.isExtensible(Temporal.TimeZone.prototype.equals),
+  true, "Built-in objects must be extensible.");
+
+assert.sameValue(Object.prototype.toString.call(Temporal.TimeZone.prototype.equals),
+  "[object Function]", "Object.prototype.toString");
+
+assert.sameValue(Object.getPrototypeOf(Temporal.TimeZone.prototype.equals),
+  Function.prototype, "prototype");
+
+assert.sameValue(Temporal.TimeZone.prototype.equals.hasOwnProperty("prototype"),
+  false, "prototype property");

test/built-ins/Temporal/TimeZone/prototype/equals/length.js

@@ -0,0 +1,25 @@
+// Copyright (C) 2023 Justin Grant. All rights reserved.
+// This code is governed by the BSD license found in the LICENSE file.
+
+/*---
+esid: sec-temporal.timezone.prototype.equals
+description: Temporal.TimeZone.prototype.equals.length is 1
+info: |
+    Every built-in function object, including constructors, has a "length" property whose value is
+    an integer. Unless otherwise specified, this value is equal to the largest number of named
+    arguments shown in the subclause headings for the function description. Optional parameters
+    (which are indicated with brackets: [ ]) or rest parameters (which are shown using the form
+    «...name») are not included in the default argument count.
+
+    Unless otherwise specified, the "length" property of a built-in function object has the
+    attributes { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true }.
+includes: [propertyHelper.js]
+features: [Temporal]
+---*/
+
+verifyProperty(Temporal.TimeZone.prototype.equals, "length", {
+  value: 1,
+  writable: false,
+  enumerable: false,
+  configurable: true,
+});

test/built-ins/Temporal/TimeZone/prototype/equals/name.js

@@ -0,0 +1,23 @@
+// Copyright (C) 2023 Justin Grant. All rights reserved.
+// This code is governed by the BSD license found in the LICENSE file.
+
+/*---
+esid: sec-temporal.timezone.prototype.equals
+description: Temporal.TimeZone.prototype.equals.name is "equals".
+info: |
+    Every built-in function object, including constructors, that is not identified as an anonymous
+    function has a "name" property whose value is a String. Unless otherwise specified, this value
+    is the name that is given to the function in this specification.
+
+    Unless otherwise specified, the "name" property of a built-in function object, if it exists,
+    has the attributes { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true }.
+includes: [propertyHelper.js]
+features: [Temporal]
+---*/
+
+verifyProperty(Temporal.TimeZone.prototype.equals, "name", {
+  value: "equals",
+  writable: false,
+  enumerable: false,
+  configurable: true,
+});

test/built-ins/Temporal/TimeZone/prototype/equals/not-a-constructor.js

@@ -0,0 +1,21 @@
+// Copyright (C) 2023 Justin Grant. All rights reserved.
+// This code is governed by the BSD license found in the LICENSE file.
+
+/*---
+esid: sec-temporal.timezone.prototype.equals
+description: >
+  Temporal.TimeZone.prototype.equals does not implement [[Construct]], is not new-able
+info: |
+    Built-in function objects that are not identified as constructors do not implement the
+    [[Construct]] internal method unless otherwise specified in the description of a particular
+    function.
+includes: [isConstructor.js]
+features: [Reflect.construct, Temporal]
+---*/
+
+assert.throws(TypeError, () => {
+  new Temporal.TimeZone.prototype.equals();
+}, "Calling as constructor");
+
+assert.sameValue(isConstructor(Temporal.TimeZone.prototype.equals), false,
+  "isConstructor(Temporal.TimeZone.prototype.equals)");

test/built-ins/Temporal/TimeZone/prototype/equals/prop-desc.js

@@ -0,0 +1,21 @@
+// Copyright (C) 2023 Justin Grant. All rights reserved.
+// This code is governed by the BSD license found in the LICENSE file.
+
+/*---
+esid: sec-temporal.timezone.prototype.equals
+description: The "equals" property of Temporal.TimeZone.prototype
+includes: [propertyHelper.js]
+features: [Temporal]
+---*/
+
+assert.sameValue(
+  typeof Temporal.TimeZone.prototype.equals,
+  "function",
+  "`typeof TimeZone.prototype.equals` is `function`"
+);
+
+verifyProperty(Temporal.TimeZone.prototype, "equals", {
+  writable: true,
+  enumerable: false,
+  configurable: true,
+});

test/built-ins/Temporal/TimeZone/prototype/equals/timezone-case-insensitive.js

@@ -0,0 +1,13 @@
+// Copyright (C) 2023 Justin Grant. All rights reserved.
+// This code is governed by the BSD license found in the LICENSE file.
+
+/*---
+esid: sec-temporal.timezone.equals
+description: Time zone names are case insensitive
+features: [Temporal]
+---*/
+
+const timeZone = 'UtC';
+const result = Temporal.TimeZone.from(timeZone);
+assert.sameValue(result.equals(timeZone), true);
+assert.sameValue(result.equals("+00:00"), false);

test/built-ins/Temporal/TimeZone/prototype/equals/timezone-string-datetime.js

@@ -0,0 +1,35 @@
+// Copyright (C) 2023 Justin Grant. All rights reserved.
+// This code is governed by the BSD license found in the LICENSE file.
+
+/*---
+esid: sec-temporal.timezone.equals
+description: Conversion of ISO date-time strings to the argument of Temporal.TimeZone.prototype.equals
+features: [Temporal]
+---*/
+
+let tzUTC = Temporal.TimeZone.from("UTC");
+let arg = "2021-08-19T17:30";
+assert.throws(RangeError, () => tzUTC.equals(arg), "bare date-time string is not a time zone");
+
+arg = "2021-08-19T17:30-07:00:01";
+assert.throws(RangeError, () => tzUTC.equals(arg), "ISO string sub-minute offset is not OK as time zone");
+
+arg = "2021-08-19T17:30Z";
+tzUTC = Temporal.TimeZone.from(arg);
+assert.sameValue(tzUTC.equals(arg), true, "date-time + Z is UTC time zone");
+
+arg = "2021-08-19T17:30-07:00";
+tzUTC = Temporal.TimeZone.from(arg);
+assert.sameValue(tzUTC.equals(arg), true, "date-time + offset is the offset time zone");
+
+arg = "2021-08-19T17:30[UTC]";
+tzUTC = Temporal.TimeZone.from(arg);
+assert.sameValue(tzUTC.equals(arg), true, "date-time + IANA annotation is the IANA time zone");
+
+arg = "2021-08-19T17:30Z[UTC]";
+tzUTC = Temporal.TimeZone.from(arg);
+assert.sameValue(tzUTC.equals(arg), true, "date-time + Z + IANA annotation is the IANA time zone");
+
+arg = "2021-08-19T17:30-07:00[UTC]";
+tzUTC = Temporal.TimeZone.from(arg);
+assert.sameValue(tzUTC.equals(arg), true, "date-time + offset + IANA annotation is the IANA time zone");

test/built-ins/Temporal/TimeZone/prototype/equals/timezone-string-multiple-offsets.js

@@ -0,0 +1,13 @@
+// Copyright (C) 2023 Justin Grant. All rights reserved.
+// This code is governed by the BSD license found in the LICENSE file.
+
+/*---
+esid: sec-temporal.timezone.from
+description: Time zone strings with UTC offset fractional part are not confused with time fractional part
+features: [Temporal]
+---*/
+
+const timeZone = "2021-08-19T17:30:45.123456789-12:12[+01:46]";
+
+const result = Temporal.TimeZone.from(timeZone);
+assert.sameValue(result.equals("+01:46"), true, "Time zone string determined from bracket name");