String.prototype.codePointAt()

Esta tradução está incompleta. Ajude a traduzir este artigo em inglês

O método codePointAt() retorna um número inteiro não negativo que é o valor do ponto de código Unicode.

Sintaxe

str.codePointAt(pos)

Parâmetros

pos
A posição de um elemento em uma string a partir do qual retorna o valor do ponto de código.

Valor retornado

Um número que representa o valor do ponto de código do caractere na pos fornecida. Se não houver nenhum elemento na pos, undefined é retornado.

Descrição

Se não houver nenhum elemento na posição especificada, é retornado o valor de undefined. Se nenhum par substituto UTF-16 começar na pos, a unidade de código na pos será retornada.

Polyfill

O seguinte código cria no objeto global String a função codePointAt() conforme especificado em ECMAScript 2015 para navegadores sem suporte nativo:

/*! https://mths.be/codepointat v0.2.0 by @mathias */
if (!String.prototype.codePointAt) {
  (function() {
    'use strict'; // needed to support `apply`/`call` with `undefined`/`null`
    var defineProperty = (function() {
      // IE 8 only supports `Object.defineProperty` on DOM elements
      try {
        var object = {};
        var $defineProperty = Object.defineProperty;
        var result = $defineProperty(object, object, object) && $defineProperty;
      } catch(error) {}
      return result;
    }());
    var codePointAt = function(position) {
      if (this == null) {
        throw TypeError();
      }
      var string = String(this);
      var size = string.length;
      // `ToInteger`
      var index = position ? Number(position) : 0;
      if (index != index) { // better `isNaN`
        index = 0;
      }
      // Account for out-of-bounds indices:
      if (index < 0 || index >= size) {
        return undefined;
      }
      // Get the first code unit
      var first = string.charCodeAt(index);
      var second;
      if ( // check if it’s the start of a surrogate pair
        first >= 0xD800 && first <= 0xDBFF && // high surrogate
        size > index + 1 // there is a next code unit
      ) {
        second = string.charCodeAt(index + 1);
        if (second >= 0xDC00 && second <= 0xDFFF) { // low surrogate
          // https://mathiasbynens.be/notes/javascript-encoding#surrogate-formulae
          return (first - 0xD800) * 0x400 + second - 0xDC00 + 0x10000;
        }
      }
      return first;
    };
    if (defineProperty) {
      defineProperty(String.prototype, 'codePointAt', {
        'value': codePointAt,
        'configurable': true,
        'writable': true
      });
    } else {
      String.prototype.codePointAt = codePointAt;
    }
  }());
}

Exemplos

Usando codePointAt()

'ABC'.codePointAt(1)           // retorna 66
'\uD800\uDC00'.codePointAt(0)  // retorna 65536

'XYZ'.codePointAt(42)          // retorna undefined

Criando um loop com codePointAt()

for (let codePoint of '\ud83d\udc0e\ud83d\udc71\u2764') {
   console.log(codePoint.codePointAt(0).toString(16)) 
} 
// retorna '1f40e', '1f471', '2764'  

Especificações

Specification
ECMAScript (ECMA-262)
The definition of 'String.prototype.codePointAt' in that specification.
Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
codePointAtChrome Full support 41Edge Full support 12Firefox Full support 29IE No support NoOpera Full support 28Safari Full support 10WebView Android Full support 41Chrome Android Full support 41Firefox Android Full support 29Opera Android Full support 28Safari iOS Full support 10Samsung Internet Android Full support 4.0nodejs Full support 4.0.0
Full support 4.0.0
Full support 0.12
Disabled
Disabled From version 0.12: this feature is behind the --harmony runtime flag.

Legend

Full support  
Full support
No support  
No support
User must explicitly enable this feature.
User must explicitly enable this feature.

Veja também