Home » Jquery » How do I convert special UTF-8 chars to their iso-8859-1 equivalent using javascript?

How do I convert special UTF-8 chars to their iso-8859-1 equivalent using javascript?

Posted by: admin November 30, 2017 Leave a comment

Questions:

I’m making a javascript app which retrieves .json files with jquery and injects data into the webpage it is embedded in.

The .json files are encoded with UTF-8 and contains accented chars like é, ö and å.

The problem is that I don’t control the charset on the pages that are going to use the app.

Some will be using UTF-8, but others will be using the iso-8859-1 charset. This will of course garble the special chars from the .json files.

How do I convert special UTF-8 chars to their iso-8859-1 equivalent using javascript?

Answers:

Actually, everything is typically stored as Unicode of some kind internally, but lets not go into that. I’m assuming you’re getting the iconic “åäö” type strings because you’re using a ISO-8859 as your character encoding. There’s a trick you can do to convert those characters. The escape and unescape functions used for encoding and decoding query strings are defined for ISO characters whereas the newer encodeURIComponent and decodeURIComponent which do the same thing, are defined for UTF8 characters.

escape encodes extended ISO-8859-1 characters (UTF code points U+0080-U+00ff) as %xx (two-digit hex) whereas it encodes UTF codepoints U+0100 and above as %uxxxx (%u followed by four-digit hex.) For example, escape("å") == "%E5" and escape("あ") == "%u3042".

encodeURIComponent percent-encodes extended characters as a UTF8 byte sequence. For example, encodeURIComponent("å") == "%C3%A5" and encodeURIComponent("あ") == "%E3%81%82".

So you can do:

fixedstring = decodeURIComponent(escape(utfstring));

For example, an incorrectly encoded character “å” becomes “Ã¥”. The command does escape("Ã¥") == "%C3%A5" which is the two incorrect ISO characters encoded as single bytes. Then decodeURIComponent("%C3%A5") == "å", where the two percent-encoded bytes are being interpreted as a UTF8 sequence.

If you’d need to do the reverse for some reason, that works too:

utfstring = unescape(encodeURIComponent(originalstring));

Is there a way to differentiate between bad UTF8 strings and and ISO strings? Turns out there is. The decodeURIComponent function used above will throw an error if given a malformed encoded sequence. We can use this to detect with a great probability whether our string is UTF8 or ISO.

var fixedstring;

try{
    // If the string is UTF-8, this will work and not throw an error.
    fixedstring=decodeURIComponent(escape(badstring));
}catch(e){
    // If it isn't, an error will be thrown, and we can asume that we have an ISO string.
    fixedstring=badstring;
}

Questions:
Answers:

The problem is that once the page is served up, the content is going to be in the encoding described in the content-type meta tag. The content in “wrong” encoding is already garbled.

You’re best to do this on the server before serving up the page. Or as I have been know to say: UTF-8 end-to-end or die.

Questions:
Answers:

Internally, Javascript strings are all Unicode (actually UCS-2, a subset of UTF-16).

If you’re retrieving the JSON files separately via AJAX, then you only need to make sure that the JSON files are served with the correct Content-Type and charset: Content-Type: application/json; charset="utf-8"). If you do that, jQuery should already have interpreted them properly by the time you access the deserialized objects.

Could you post an example of the code you’re using to retrieve the JSON objects?

Questions:
Answers:

Since the question on how to convert from ISO-8859-1 to UTF-8 is closed because of this one I’m going to post my solution here.

The problem is when you try to GET anything by using XMLHttpRequest, if the XMLHttpRequest.responseType is “text” or empty, the XMLHttpRequest.response is transformed to a DOMString and that’s were things break up. After, it’s almost impossible to reliably work with that string.

Now, if the content from the server is ISO-8859-1 you’ll have to force the response to be of type “Blob” and later convert this to DOMSTring. For example:

var ajax = new XMLHttpRequest();
ajax.open('GET', url, true);
ajax.responseType = 'blob';
ajax.onreadystatechange = function(){
    ...
    if(ajax.responseType === 'blob'){
        // Convert the blob to a string
        var reader = new window.FileReader();
        reader.addEventListener('loadend', function() {
           // For ISO-8859-1 there's no further conversion required
           Promise.resolve(reader.result);
        });
        reader.readAsBinaryString(ajax.response);
    }
}

Seems like the magic is happening on readAsBinaryString so maybe someone can shed some light on why this works.

Questions:
Answers:

I was looking for this answer, but think in one line against many code, could be something like this:

   var converted = "<?php echo mb_convert_encoding($str_to_convert, 'UTF-8', 'ISO-8859-1'); ?>";

That worked for me, but if you put the var into php, like this:

   document.write("<?php $str_to_convert = " + your_str + " ?>");

Hope this also helps to anyone.

Questions:
Answers:

you should add this line above your page

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />