The join() method joins all elements of an array into a string. This method has the same algorithm as Array.prototype.join(). TypedArray is one of the typed array types here.

Syntax

typedarray.join([separator = ',']);

Parameters

separator
Optional. Specifies a string to separate each element. The separator is converted to a string if necessary. If omitted, the typed array elements are separated with a comma (",").

Return value

A string with all array elements joined.

Examples

var uint8 = new Uint8Array([1,2,3]);
uint8.join();      // '1,2,3'
uint8.join(' / '); // '1 / 2 / 3'
uint8.join('');    // '123'

Polyfill

Since there is no global object with the name TypedArray, polyfilling must be done on an "as needed" basis.

// https://tc39.github.io/ecma262/#sec-%typedarray%.prototype.join
if (!Uint8Array.prototype.join) {
  Object.defineProperty(Uint8Array.prototype, 'join', {
    value: Array.prototype.join
  });
}

If you need to support truly obsolete JavaScript engines that don't support Object.defineProperty, it's best not to polyfill Array.prototype methods at all, as you can't make them non-enumerable.

Specifications

Specification Status Comment
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'TypedArray.prototype.join' in that specification.
Standard Initial definition.
ECMAScript Latest Draft (ECMA-262)
The definition of 'TypedArray.prototype.join' in that specification.
Draft  

Browser compatibility

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung InternetNode.js
Basic supportChrome Full support YesEdge Full support 14Firefox Full support 37IE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support 37Opera Android No support NoSafari iOS No support NoSamsung Internet Android Full support Yesnodejs Full support 4.0.0

Legend

Full support  
Full support
No support  
No support

See also

Document Tags and Contributors

Last updated by: wbamberg,