W3cubDocs

Symbol.split

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨January 2020⁩.

The Symbol.split static data property represents the well-known symbol Symbol.split. The String.prototype.split() method looks up this symbol on its first argument for the method that splits a string at the indices that match the current object.

For more information, see RegExp.prototype[Symbol.split]() and String.prototype.split().

Try it

class Split1 {
  constructor(value) {
    this.value = value;
  }
  [Symbol.split](string) {
    const index = string.indexOf(this.value);
    return `${this.value}${string.substring(0, index)}/${string.substring(
      index + this.value.length,
    )}`;
  }
}

console.log("foobar".split(new Split1("foo")));
// Expected output: "foo/bar"

Value

The well-known symbol Symbol.split.

Property attributes of `Symbol.split`
Writable	no
Enumerable	no
Configurable	no

Examples

Custom reverse split

class ReverseSplit {
  [Symbol.split](string) {
    const array = string.split(" ");
    return array.reverse();
  }
}

console.log("Another one bites the dust".split(new ReverseSplit()));
// [ "dust", "the", "bites", "one", "Another" ]

Specifications

Specification
ECMAScript® 2026 Language Specification> # sec-symbol.split>

Browser compatibility

	Desktop					Mobile							Server
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS	Bun	Deno	Node.js
`split`	50	79	49	37	10	50	49	37	10	5.0	50	10	1.0.0	1.0	6.0.0