Ponad 2 lata temu Renato Mangini opisał metodę konwersji między nieprzetworzonymi komponentami ArrayBuffers i odpowiednią reprezentacją tych danych w postaci ciągu znaków. Na koniec Renato wspomniał, że przygotowujemy oficjalny, standardowy interfejs API do obsługi konwersji. Specyfikacja jest już dopracowana. Zarówno przeglądarka Firefox, jak i Google Chrome mają wbudowaną obsługę interfejsów TextDecoder i TextEncoder.
Jak pokazano w tym przykładzie transmisji na żywo zatytułowanym poniżej, interfejs Encoding API ułatwia tłumaczenie między nieprzetworzonymi bajtami a natywnymi ciągami JavaScriptu niezależnie od tego, z jakim z wielu standardowych kodowań musisz pracować.
<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>
W przykładzie powyżej użyto wykrywania funkcji do określenia, czy wymagany interfejs TextDecoder
jest dostępny w bieżącej przeglądarce. W razie potrzeby wyświetla się komunikat o błędzie. W praktyce w praktyce zwykle zalecamy przejście na alternatywną implementację, jeśli obsługa natywna nie jest dostępna. Na szczęście biblioteka kodowania tekstu, o której wspomniał w swoim oryginalnym artykule, nadal jest dobrym rozwiązaniem. Biblioteka korzysta z metod natywnych w przeglądarkach, które je obsługują, i oferuje kody polyfill dla interfejsu Encoding API w przeglądarkach, które jeszcze ich nie obsługują.
Aktualizacja z września 2014 roku: zmodyfikowaliśmy przykład, by pokazać, czy interfejs Encoding API jest dostępny w bieżącej przeglądarce.