1.38.0isEmail
بررسی می‌کند که آیا یک مقدار رشته‌ای است که با قوانین اعتبارسنجی ایمیل این تابع مطابقت دارد یا نه.
isEmail(value):booleanقوانین اعتبارسنجی
مقدار باید از نوع string باشد. قبل از اعتبارسنجی، ابتدا و انتهای رشته trim می‌شود و رشته باید دقیقاً یک کاراکتر @ داشته باشد. بخش محلی باید خالی نباشد، نمی‌تواند با نقطه شروع یا تمام شود و نباید شامل نقطه‌های متوالی باشد. کاراکترهای مجاز بخش محلی شامل حروف و اعداد ASCII و کاراکترهای .!#$%&'*+/=?^_`{|}~- هستند.
قوانین دامنه
دامنه نباید خالی باشد، باید حداقل یک نقطه داشته باشد و نمی‌تواند با نقطه شروع یا تمام شود یا شامل نقطه‌های متوالی باشد. هر بخش دامنه باید غیرخالی باشد، فقط شامل حروف و اعداد ASCII و خط تیره باشد و نمی‌تواند با خط تیره شروع یا تمام شود.
Type Guard
این تابع یک TypeScript Type Guard است. وقتی مقدار true باشد، TypeScript نوع value را از unknown به string محدود می‌کند.
پارامترها
valueunknownالزامیمقداری که باید به‌عنوان آدرس ایمیل اعتبارسنجی شود.
مقدار بازگشتی
booleanاگر مقدار یک رشته معتبر مطابق قوانین این تابع باشد true و در غیر این صورت false برمی‌گرداند.
مثال‌ها
ایمیل معتبر
برای رشته‌ای که قوانین اعتبارسنجی را رعایت کند true برمی‌گرداند.
isEmail("amir@example.com");
// trueایمیل نامعتبر
وقتی ساختار ایمیل با قوانین اعتبارسنجی مطابقت نداشته باشد false برمی‌گرداند.
isEmail("amir@example");
// falseمقدار غیررشته‌ای
مقادیر غیررشته‌ای بلافاصله رد می‌شوند.
isEmail(123);
// false
isEmail(null);
// falseفاصله‌های ابتدا و انتها
فاصله‌های ابتدا و انتهای مقدار قبل از اعتبارسنجی حذف می‌شوند.
isEmail(" amir@example.com ");
// trueبخش محلی نامعتبر
بخش محلی نمی‌تواند با نقطه شروع یا تمام شود و نباید شامل دو نقطه متوالی باشد.
isEmail(".amir@example.com");
// false
isEmail("amir..test@example.com");
// falseدامنه نامعتبر
دامنه باید حداقل یک نقطه داشته باشد و بخش‌های آن نمی‌توانند با خط تیره شروع یا تمام شوند.
isEmail("amir@example");
// false
isEmail("amir@-example.com");
// false