valia/test/testers/string/isEmail.test.mjs

A runtime data validator in TypeScript with advanced type inference, built-in validation functions, and seamless integration for server and client environments.

import { describe, it } from "node:test";
import assert from "node:assert";

import { isEmail } from "../../../dist/index.js";

describe("\ntesters / string / isEmail", () => {
	describe("Default", () => {
		it("should invalidate incorrect values", () => {
			assert.strictEqual(isEmail(""), false);
			assert.strictEqual(isEmail(0), false);
			assert.strictEqual(isEmail("foo"), false);
			assert.strictEqual(isEmail("foo.bar"), false);
			assert.strictEqual(isEmail("foo.bar@"), false);
			assert.strictEqual(isEmail("foo\"bar@foo"), false);
		});

		it("should validate correct values", () => {
			assert.strictEqual(isEmail("f@b"), true);
			assert.strictEqual(isEmail("foo.bar@bar"), true);
			assert.strictEqual(isEmail("foo.bar@bar.fo"), true);
		});
	});

	describe("'allowQuotedString' parameter", () => {
		it("should invalidate incorrect values", () => {
			assert.strictEqual(isEmail("\"te\"st\"@bar.fo", { allowQuotedString: true }), false);
			assert.strictEqual(isEmail("\"\"te\"st\"@bar.fo", { allowQuotedString: true }), false);
			assert.strictEqual(isEmail("\"te\"st\"\"@bar.fo", { allowQuotedString: true }), false);
		});

		it("should validate correct values", () => {
			assert.strictEqual(isEmail("\"te\\\"st\"@bar.fo", { allowQuotedString: true }), true);
			assert.strictEqual(isEmail("\"\\\"test\"@bar.fo", { allowQuotedString: true }), true);
			assert.strictEqual(isEmail("\"test\\\"\"@bar.fo", { allowQuotedString: true }), true);
		});
	});

	describe("'allowIpAddress' parameter (IPV4)", () => {
		it("should invalidate incorrect values", () => {
			assert.strictEqual(isEmail("foo@[0.0.0.01]", { allowIpAddress: true }), false);
			assert.strictEqual(isEmail("foo@[01.0.0.0]", { allowIpAddress: true }), false);
			assert.strictEqual(isEmail("foo@[0.0.0.0.1]", { allowIpAddress: true }), false);
			assert.strictEqual(isEmail("foo@[0.0.0.256]", { allowIpAddress: true }), false);
		});

		it("should validate correct values", () => {
			assert.strictEqual(isEmail("foo@[0.0.0.0]", { allowIpAddress: true }), true);
			assert.strictEqual(isEmail("foo@[255.255.255.255]", { allowIpAddress: true }), true);
		});
	});

	describe("'allowIpAddress' parameter (IPV6)", () => {
		it("should invalidate incorrect values", () => {
			assert.strictEqual(isEmail("foo@[::ffff]", { allowIpAddress: true }), false);
			assert.strictEqual(isEmail("foo@[IPv6:0000:0000:0000:0000:0000:0000:0000:00001]", { allowIpAddress: true }), false);
			assert.strictEqual(isEmail("foo@[IPv6:::ffff::]", { allowIpAddress: true }), false);
			assert.strictEqual(isEmail("foo@[IPv6:::ffff:192.168.1.256]", { allowIpAddress: true }), false);
		});

		it("should validate correct values", () => {
			assert.strictEqual(isEmail("foo@[IPv6:0000:0000:0000:0000:0000:0000:0000:0000]", { allowIpAddress: true }), true);
			assert.strictEqual(isEmail("foo@[IPv6:::ffff]", { allowIpAddress: true }), true);
			assert.strictEqual(isEmail("foo@[IPv6:::ffff:192.168.1.255]", { allowIpAddress: true }), true);
		});
	});
});