serenity/Userland/Libraries/LibJS/Tests/builtins/Temporal/PlainYearMonth/PlainYearMonth.from.js

describe("correct behavior", () => {
    test("length is 1", () => {
        expect(Temporal.PlainYearMonth.from).toHaveLength(1);
    });

    test("PlainDate instance argument", () => {
        const plainDate = new Temporal.PlainDate(2021, 7, 6);
        const plainYearMonth = Temporal.PlainYearMonth.from(plainDate);
        expect(plainYearMonth.year).toBe(2021);
        expect(plainYearMonth.month).toBe(7);
        expect(plainYearMonth.monthCode).toBe("M07");
        expect(plainYearMonth.daysInYear).toBe(365);
        expect(plainYearMonth.daysInMonth).toBe(31);
        expect(plainYearMonth.monthsInYear).toBe(12);
        expect(plainYearMonth.inLeapYear).toBeFalse();
    });

    test("PlainYearMonth instance argument", () => {
        const plainYearMonth_ = new Temporal.PlainYearMonth(2021, 7);
        const plainYearMonth = Temporal.PlainYearMonth.from(plainYearMonth_);
        expect(plainYearMonth.year).toBe(2021);
        expect(plainYearMonth.month).toBe(7);
        expect(plainYearMonth.monthCode).toBe("M07");
        expect(plainYearMonth.daysInYear).toBe(365);
        expect(plainYearMonth.daysInMonth).toBe(31);
        expect(plainYearMonth.monthsInYear).toBe(12);
        expect(plainYearMonth.inLeapYear).toBeFalse();
    });

    test("ZonedDateTime instance argument", () => {
        const timeZone = new Temporal.TimeZone("UTC");
        const zonedDateTime = new Temporal.ZonedDateTime(1625614921000000000n, timeZone);
        const plainYearMonth = Temporal.PlainYearMonth.from(zonedDateTime);
        expect(plainYearMonth.year).toBe(2021);
        expect(plainYearMonth.month).toBe(7);
        expect(plainYearMonth.monthCode).toBe("M07");
        expect(plainYearMonth.daysInYear).toBe(365);
        expect(plainYearMonth.daysInMonth).toBe(31);
        expect(plainYearMonth.monthsInYear).toBe(12);
        expect(plainYearMonth.inLeapYear).toBeFalse();
    });

    test("fields object argument", () => {
        const object = {
            year: 2021,
            month: 7,
        };
        const plainYearMonth = Temporal.PlainYearMonth.from(object);
        expect(plainYearMonth.year).toBe(2021);
        expect(plainYearMonth.month).toBe(7);
        expect(plainYearMonth.monthCode).toBe("M07");
        expect(plainYearMonth.daysInYear).toBe(365);
        expect(plainYearMonth.daysInMonth).toBe(31);
        expect(plainYearMonth.monthsInYear).toBe(12);
        expect(plainYearMonth.inLeapYear).toBeFalse();
    });

    test("from year month string", () => {
        const plainYearMonth = Temporal.PlainYearMonth.from("2021-07");
        expect(plainYearMonth.year).toBe(2021);
        expect(plainYearMonth.month).toBe(7);
        expect(plainYearMonth.monthCode).toBe("M07");
    });

    test("from date time string", () => {
        const plainYearMonth = Temporal.PlainYearMonth.from("2021-07-06T23:42:01");
        expect(plainYearMonth.year).toBe(2021);
        expect(plainYearMonth.month).toBe(7);
        expect(plainYearMonth.monthCode).toBe("M07");
        expect(plainYearMonth.daysInYear).toBe(365);
        expect(plainYearMonth.daysInMonth).toBe(31);
        expect(plainYearMonth.monthsInYear).toBe(12);
        expect(plainYearMonth.inLeapYear).toBeFalse();
    });

    test("compares calendar name in year month string in lowercase", () => {
        const values = [
            "2023-02[u-ca=iso8601]",
            "2023-02[u-ca=isO8601]",
            "2023-02[u-ca=iSo8601]",
            "2023-02[u-ca=iSO8601]",
            "2023-02[u-ca=Iso8601]",
            "2023-02[u-ca=IsO8601]",
            "2023-02[u-ca=ISo8601]",
            "2023-02[u-ca=ISO8601]",
        ];

        for (const value of values) {
            expect(() => {
                Temporal.PlainYearMonth.from(value);
            }).not.toThrowWithMessage(
                RangeError,
                "YYYY-MM string format can only be used with the iso8601 calendar"
            );
        }
    });
});

describe("errors", () => {
    test("missing fields", () => {
        expect(() => {
            Temporal.PlainYearMonth.from({});
        }).toThrowWithMessage(TypeError, "Required property year is missing or undefined");
        expect(() => {
            Temporal.PlainYearMonth.from({ year: 0 });
        }).toThrowWithMessage(TypeError, "Required property month is missing or undefined");
        expect(() => {
            Temporal.PlainYearMonth.from({ month: 1 });
        }).toThrowWithMessage(TypeError, "Required property year is missing or undefined");
    });

    test("invalid year month string", () => {
        expect(() => {
            Temporal.PlainYearMonth.from("foo");
        }).toThrowWithMessage(RangeError, "Invalid year month string 'foo'");
    });

    test("string must not contain a UTC designator", () => {
        expect(() => {
            Temporal.PlainYearMonth.from("2021-07-06T23:42:01Z");
        }).toThrowWithMessage(
            RangeError,
            "Invalid year month string '2021-07-06T23:42:01Z': must not contain a UTC designator"
        );
    });

    test("extended year must not be negative zero", () => {
        expect(() => {
            Temporal.PlainYearMonth.from("-000000-01");
        }).toThrowWithMessage(RangeError, "Invalid year month string '-000000-01'");
        expect(() => {
            Temporal.PlainYearMonth.from("−000000-01"); // U+2212
        }).toThrowWithMessage(RangeError, "Invalid year month string '−000000-01'");
    });

    test("can only use iso8601 calendar with year month strings", () => {
        expect(() => {
            Temporal.PlainYearMonth.from("2023-02[u-ca=iso8602]");
        }).toThrowWithMessage(
            RangeError,
            "YYYY-MM string format can only be used with the iso8601 calendar"
        );

        expect(() => {
            Temporal.PlainYearMonth.from("2023-02[u-ca=SerenityOS]");
        }).toThrowWithMessage(
            RangeError,
            "YYYY-MM string format can only be used with the iso8601 calendar"
        );
    });

    test("doesn't throw non-iso8601 calendar error when using a superset format string such as DateTime", () => {
        // NOTE: This will still throw, but only because "serenity" is not a recognised calendar, not because of the string format restriction.
        try {
            Temporal.PlainYearMonth.from("2023-02-10T22:57[u-ca=serenity]");
        } catch (e) {
            expect(e).toBeInstanceOf(RangeError);
            expect(e.message).not.toBe(
                "MM-DD string format can only be used with the iso8601 calendar"
            );
            expect(e.message).toBe("Invalid calendar identifier 'serenity'");
        }
    });
});