encodeUrl

یک نشانی را با احتیاط کدگذاری می‌کند: دنباله‌های از پیش کدگذاری‌شده را دست‌نخورده می‌گذارد و جفت‌های جانشین بی‌قرین را هم می‌رساند.

API

encodeUrl

بازگشت

آرگومان توضیح نوع
string نشانی کدگذاری‌شده string

پارامترها

پارامتر توضیح نوع پیش‌فرض
url نشانی‌ای که کدگذاری می‌شود string الزامی

نمونه

کاربرد پایه

import { encodeUrl } from 'ranuts';

const url = 'https://example.com/path with spaces';
const encoded = encodeUrl(url);
console.log(encoded); // 'https://example.com/path%20with%20spaces'

نشانی‌های از پیش کدگذاری‌شده

import { encodeUrl } from 'ranuts';

// آنچه پیش‌تر کدگذاری شده دوباره کدگذاری نمی‌شود
const url = 'https://example.com/path%20with%20spaces';
const encoded = encodeUrl(url);
console.log(encoded); // 'https://example.com/path%20with%20spaces'

نویسه‌های ویژه

import { encodeUrl } from 'ranuts';

const url = 'https://example.com/search?q=hello world&lang=zh-CN';
const encoded = encodeUrl(url);
console.log(encoded); // نشانی کدگذاری‌شده

کدگذاری‌های خراب

import { encodeUrl } from 'ranuts';

// دنباله‌های خراب (مانند %foo) دوباره کدگذاری می‌شوند
const url = 'https://example.com/path%foo';
const encoded = encodeUrl(url);
console.log(encoded); // 'https://example.com/path%25foo'

یادداشت‌ها

  1. کدگذاری هوشمند: تنها بخش‌های کدگذاری‌نشده را دست می‌زند و دنباله‌های از پیش کدگذاری‌شده مانند %20 را همان‌طور می‌گذارد.
  2. جفت‌های جانشین: جفت‌های جانشین بی‌قرین خودبه‌خود رسیدگی و با نویسهٔ جایگزین یونیکد عوض می‌شوند.
  3. ایمنی: خطایی پرتاب نمی‌کند و تا جای ممکن نشانی را درست کدگذاری می‌کند.
  4. کاربرد: معمولاً برای نشانی‌هایی که کاربر وارد می‌کند و برای ساختن نشانی‌های امن به کار می‌رود.