दो साल से ज़्यादा पहले, रेनाटो मैंगिन ने रॉ ArrayBuffers और उस डेटा की स्ट्रिंग के बीच बदलाव करने का तरीका बताया था. पोस्ट के आखिर में, रेनाटो ने बताया कि कन्वर्ज़न को मैनेज करने के लिए, आधिकारिक स्टैंडर्ड एपीआई का ड्राफ़्ट तैयार किया जा रहा है. स्पेसिफ़िकेशन अब तैयार हो गया है. Firefox और Google Chrome, दोनों ने TextDecoder और TextEncoder इंटरफ़ेस के लिए नेटिव सपोर्ट जोड़ा है.
इस लाइव सैंपल में दिखाया गया है कि Encoding API की मदद से, रॉ बाइट और नेटिव JavaScript स्ट्रिंग के बीच आसानी से ट्रांसलेट किया जा सकता है. भले ही, आपको कई स्टैंडर्ड एन्कोडिंग में से किसी भी एन्कोडिंग का इस्तेमाल करना हो.
<pre id="results"></pre>
<script>
if ('TextDecoder' in window) {
// The local files to be fetched, mapped to the encoding that they're using.
var filesToEncoding = {
'utf8.bin': 'utf-8',
'utf16le.bin': 'utf-16le',
'macintosh.bin': 'macintosh'
};
Object.keys(filesToEncoding).forEach(function(file) {
fetchAndDecode(file, filesToEncoding[file]);
});
} else {
document.querySelector('#results').textContent = 'Your browser does not support the Encoding API.'
}
// Use XHR to fetch `file` and interpret its contents as being encoded with `encoding`.
function fetchAndDecode(file, encoding) {
var xhr = new XMLHttpRequest();
xhr.open('GET', file);
// Using 'arraybuffer' as the responseType ensures that the raw data is returned,
// rather than letting XMLHttpRequest decode the data first.
xhr.responseType = 'arraybuffer';
xhr.onload = function() {
if (this.status == 200) {
// The decode() method takes a DataView as a parameter, which is a wrapper on top of the ArrayBuffer.
var dataView = new DataView(this.response);
// The TextDecoder interface is documented at http://encoding.spec.whatwg.org/#interface-textdecoder
var decoder = new TextDecoder(encoding);
var decodedString = decoder.decode(dataView);
// Add the decoded file's text to the <pre> element on the page.
document.querySelector('#results').textContent += decodedString + '\n';
} else {
console.error('Error while requesting', file, this);
}
};
xhr.send();
}
</script>
ऊपर दिए गए सैंपल में, सुविधा का पता लगाने की सुविधा का इस्तेमाल करके यह पता लगाया जाता है कि मौजूदा ब्राउज़र में ज़रूरी TextDecoder
इंटरफ़ेस उपलब्ध है या नहीं. अगर इंटरफ़ेस उपलब्ध नहीं है, तो गड़बड़ी का मैसेज दिखता है. किसी असल ऐप्लिकेशन में, आम तौर पर नेटिव सपोर्ट उपलब्ध न होने पर, किसी अन्य तरीके से लागू करने का विकल्प चुना जाता है. सौभाग्य से, रेनाटो ने अपने मूल लेख में जिस टेक्स्ट-कोडिंग लाइब्रेरी का ज़िक्र किया है वह अब भी एक अच्छा विकल्प है. लाइब्रेरी, उन ब्राउज़र पर नेटिव तरीकों का इस्तेमाल करती है जिन पर ये काम करते हैं. साथ ही, उन ब्राउज़र पर Encoding API के लिए polyfills की सुविधा देती है जिन पर अभी तक यह सुविधा नहीं जोड़ी गई है.
सितंबर 2014 का अपडेट: सैंपल में बदलाव किया गया है, ताकि यह पता लगाया जा सके कि मौजूदा ब्राउज़र में Encoding API उपलब्ध है या नहीं.