1.38.0isURL
بررسی می‌کند که آیا یک مقدار یک URL معتبر است و فقط پروتکل‌های HTTP و HTTPS را قبول می‌کند.
isURL(value):booleanاعتبارسنجی
تابع ابتدا بررسی می‌کند که مقدار از نوع string باشد، سپس آن را trim می‌کند و رشته‌های خالی را رد می‌کند. در ادامه مقدار را به URL constructor داخلی JavaScript می‌دهد.
پروتکل‌های پشتیبانی‌شده
پس از تجزیه URL، تابع فقط پروتکل‌های http: و https: را قبول می‌کند. سایر پروتکل‌های معتبر URL نیز رد می‌شوند.
URLهای نامعتبر
اگر URL constructor هنگام تجزیه مقدار خطا ایجاد کند، تابع خطا را catch کرده و false برمی‌گرداند.
Type Guard
این تابع یک TypeScript Type Guard است. وقتی true برگرداند، TypeScript نوع value را از unknown به string محدود می‌کند.
پارامترها
valueunknownالزامیمقداری که باید به‌عنوان URL اعتبارسنجی شود.
مقدار بازگشتی
booleanاگر مقدار بتواند به‌عنوان یک URL با پروتکل HTTP یا HTTPS تجزیه شود true و در غیر این صورت false برمی‌گرداند.
مثال‌ها
URL معتبر HTTP
URLهای HTTP پذیرفته می‌شوند.
isURL("http://example.com");
// trueURL معتبر HTTPS
URLهای HTTPS پذیرفته می‌شوند.
isURL("https://example.com/path?query=1");
// trueپروتکل پشتیبانی‌نشده
URLهایی با پروتکل‌هایی غیر از HTTP و HTTPS رد می‌شوند.
isURL("ftp://example.com");
// false
isURL("mailto:test@example.com");
// falseURL نامعتبر
مقادیر که توسط URL constructor داخلی JavaScript قابل تجزیه نباشند رد می‌شوند.
isURL("not-a-url");
// false
isURL("example.com");
// falseفاصله‌های ابتدا و انتها
فاصله‌های ابتدا و انتهای مقدار قبل از اعتبارسنجی حذف می‌شوند.
isURL(" https://example.com ");
// trueمقدار غیررشته‌ای
مقادیر غیررشته‌ای رد می‌شوند.
isURL(123);
// false
isURL(null);
// false