URL кодер/декодер + HTML ентитети

Функција и намена на URL кодирањето и декодирањето

При пренос на податоци преку Интернет, одредени карактери имаат специјално значење во рамките на една URL-адреса. URL кодирањето (познато и како процентуално кодирање) овозможува безбедно пренесување на информациите преку веб-протоколите со тоа што ги претвора карактерите кои не се дозволени или имаат резервирана намена во безбеден формат. Овој процес е неопходен за програмери, уредници на содржини и техничка поддршка кои треба безбедно да вметнат текст во делови од URL-адреси, како што се вредности на параметри, делови од патеки или вредности на форми.

Процесот на декодирање го прави спротивното: ги зема процентуално кодираните низи и ги враќа во нивниот оригинален, читлив формат. Ова е корисно за секој што има потреба да прочита постоечки процентуално кодиран текст.

Разлика меѓу кодирање на URL компонента и целосна URL-адреса

Алатката нуди две нивоа на опсег при обработка на URL-адреси, кои директно влијаат на тоа кои карактери ќе бидат конвертирани:

1. Компонента: Оваа опција ја користи JavaScript функцијата encodeURIComponent за кодирање, односно decodeURIComponent за декодирање. Таа е наменета за обработка на поединечни делови од URL-адресата, како што се вредностите на клучовите во прашалните низи (query parameters). Притоа, се кодираат речиси сите специјални карактери, вклучувајќи ги :, /, ?, & и =.
2. Целосна URL-адреса: Оваа опција ги користи функциите encodeURI и decodeURI. Се применува кога сакате да ја кодирате целата адреса, но притоа карактерите со структурно значење како :, /, ?, & и = треба да останат непроменети и читливи за да се зачува валидноста на самата URL-адреса.

Кога во алатката е избран режимот за HTML ентитети, контролата за избор на опсег на URL автоматски се крие.

Кодирање и декодирање на HTML ентитети

HTML кодирањето (HTML entity escaping) е процес со кој одредени карактери се заменуваат со нивните соодветни HTML ентитети. Оваа операција ги претвора карактерите како што се <, >, &, наводниците, како и не-ASCII текстот во ентитети.

Главната цел на ова кодирање е да го направи текстот безбеден за лепење во HTML содржина или HTML атрибути. На пример, доколку текстот содржи карактер како <, прелистувачот може да го протолкува како почеток на HTML таг. Со негово претворање во соодветниот ентитет, прелистувачот правилно ќе го прикаже карактерот без да го изврши како код. Декодирањето (unescaping) го враќа кодираниот HTML текст во неговата првична форма.

Важно е да се нагласи разликата помеѓу кодирањето/избегнувањето (escaping) и безбедносното чистење (sanitization). Кодирањето само го трансформира записот на карактерите за тие да бидат правилно прикажани од прелистувачот, додека безбедносното чистење е посебен процес на отстранување или неутрализирање на потенцијално опасен код.

Процентуални кодови и UTF-8 барања

При декодирање на URL-адреси, процентуалните кодови мора да претставуваат комплетни UTF-8 секвенци. Секој кодиран карактер надвор од стандардниот ASCII опсег се претставува со еден или повеќе бајти во UTF-8 формат, каде секој бајт е означен со знакот % проследен со две хексадецимални цифри.

Доколку влезот содржи нецелосна или скршена секвенца, процесот на декодирање не може да заврши. На пример, неисправна секвенца како %E0%A4%A ќе предизвика грешка при декодирањето.

Правила за користење и ограничувања на алатката

Алатката работи под дефинирани технички правила и ограничувања за да се обезбеди стабилност при обработката:

• Максимална големина: Алатката прифаќа влез со максимална должина до 2.000.000 карактери.
• Информации за големина: Алатката во реално време ги прикажува карактерните големини за „Влез“ и „Излез“.
• Локална обработка: Сите конверзии се извршуваат директно во вашиот веб-прелистувач. Вашиот URL и HTML текст се конвертира во вашиот прелистувач. Ништо не се испраќа на BroBroGo.

Пораки за состојба и грешки во интерфејсот

Во зависност од акциите и состојбата на влезот, алатката ги прикажува следниве системски пораки:

• Кога нема внесен текст, се прикажува: „Прво залепете некаков влез.“
• Ако влезот го надмине лимитот: „Внесот е премногу долг за оваа алатка. Кратете го под {max} карактери.“
• При предолг процес на конверзија: „Оваа конверзија трае премногу долго. Обидете се со помал влез.“
• При неисправни процентуални кодови: „Овој URL текст има неисправно процентуално кодирање.“
• При други грешки во конверзијата: „Овој влез не можеше да се конвертира.“
• При успешно чистење на полињата преку копчето за чистење: „Влезот и излезот се исчистени.“
• При префрлање на резултатот во влезната позиција: „Излезот е преместен во влез.“
• При вчитување на примерок за тест: „Примерот е вчитан.“

Чекори за користење на алатката

1. Во полето за влез внесете го или залепете го саканиот текст.
2. Изберете ја соодветната алатка во менито „Алатка“: „URL“ или „HTML ентитети“.
3. Доколку изберете „URL“, поставете го саканиот „Опсег на URL“ на „Компонента“ или „Целосна URL-адреса“.
4. Изберете ја акцијата во менито „Акција“: „Кодирај / додај escape“ или „Декодирај / отстрани escape“.
5. Кликнете на копчето „Конвертирај“ за да го добиете резултатот во полето за излез.
6. Можете да го искористите копчето „Користи го излезот“ за да го префрлите резултатот назад во влезот, или „Исчисти“ за да ги испразните двете полиња.

Често поставувани прашања (FAQ)

Дали треба да изберам URL компонента или целосна URL-адреса?
Користете „Компонента“ за вредности на параметри, делови од патеки или вредности на форми. Користете „Целосна URL-адреса“ кога сакате карактерите како: /? & = да останат читливи.

Што менува кодирањето на HTML ентитети (HTML entity escaping)?
Ги претвора карактерите како <, >, &, наводниците и не-ASCII текстот во ентитети кои можат безбедно да се залепат во HTML текст или атрибути.

Зошто декодирањето на URL понекогаш не успева?
Процентуалното кодирање мора да биде во комплетни UTF-8 секвенци. Скршена секвенца како %E0%A4%A не може да се декодира без нагодување.

Каде се испраќаат моите податоци при конверзијата?
Вашиот URL и HTML текст се конвертира во вашиот прелистувач. Ништо не се испраќа на BroBroGo, што значи дека обработката е целосно локална.