LibJS: Implement Temporal.ZonedDateTime.prototype.with()

Userland/Libraries/LibJS/Tests/builtins/Temporal/ZonedDateTime/ZonedDateTime.prototype.with.js

@@ -0,0 +1,85 @@
+describe("correct behavior", () => {
+    test("length is 1", () => {
+        expect(Temporal.ZonedDateTime.prototype.with).toHaveLength(1);
+    });
+
+    test("basic functionality", () => {
+        const utc = new Temporal.TimeZone("UTC");
+        const zonedDateTime = new Temporal.ZonedDateTime(0n, utc);
+        const values = [
+            [{ year: 2021 }, 1609459200000000000n],
+            [{ year: 2021, month: 7 }, 1625097600000000000n],
+            [{ year: 2021, month: 7, day: 6 }, 1625529600000000000n],
+            [{ year: 2021, monthCode: "M07", day: 6 }, 1625529600000000000n],
+            [{ hour: 18, minute: 14, second: 47 }, 65687000000000n],
+            [
+                {
+                    year: 2021,
+                    month: 7,
+                    day: 6,
+                    hour: 18,
+                    minute: 14,
+                    second: 47,
+                    millisecond: 123,
+                    microsecond: 456,
+                    nanosecond: 789,
+                },
+                1625595287123456789n,
+            ],
+        ];
+        for (const [arg, epochNanoseconds] of values) {
+            const expected = new Temporal.ZonedDateTime(epochNanoseconds, utc);
+            expect(zonedDateTime.with(arg).equals(expected)).toBeTrue();
+        }
+
+        // Supplying the same values doesn't change the date/time, but still creates a new object
+        const zonedDateTimeLike = {
+            year: zonedDateTime.year,
+            month: zonedDateTime.month,
+            day: zonedDateTime.day,
+            hour: zonedDateTime.hour,
+            minute: zonedDateTime.minute,
+            second: zonedDateTime.second,
+            millisecond: zonedDateTime.millisecond,
+            microsecond: zonedDateTime.microsecond,
+            nanosecond: zonedDateTime.nanosecond,
+        };
+        expect(zonedDateTime.with(zonedDateTimeLike)).not.toBe(zonedDateTime);
+        expect(zonedDateTime.with(zonedDateTimeLike).equals(zonedDateTime)).toBeTrue();
+    });
+});
+
+describe("errors", () => {
+    test("this value must be a Temporal.ZonedDateTime object", () => {
+        expect(() => {
+            Temporal.ZonedDateTime.prototype.with.call("foo");
+        }).toThrowWithMessage(TypeError, "Not an object of type Temporal.ZonedDateTime");
+    });
+
+    test("argument must be an object", () => {
+        expect(() => {
+            new Temporal.ZonedDateTime(0n, {}).with("foo");
+        }).toThrowWithMessage(TypeError, "foo is not an object");
+        expect(() => {
+            new Temporal.ZonedDateTime(0n, {}).with(42);
+        }).toThrowWithMessage(TypeError, "42 is not an object");
+    });
+
+    test("argument must have one of 'day', 'hour', 'microsecond', 'millisecond', 'minute', 'month', 'monthCode', 'nanosecond', 'second', 'year'", () => {
+        expect(() => {
+            new Temporal.ZonedDateTime(0n, {}).with({});
+        }).toThrowWithMessage(
+            TypeError,
+            "Object must have at least one of the following properties: day, hour, microsecond, millisecond, minute, month, monthCode, nanosecond, second, year"
+        );
+    });
+
+    test("argument must not have 'calendar' or 'timeZone'", () => {
+        expect(() => {
+            new Temporal.ZonedDateTime(0n, {}).with({ calendar: {} });
+        }).toThrowWithMessage(TypeError, "Object must not have a defined calendar property");
+        expect(() => {
+            new Temporal.ZonedDateTime(0n, {}).with({ timeZone: {} });
+        }).toThrowWithMessage(TypeError, "Object must not have a defined timeZone property");
+    });
+});