Creates a new string.

Parameters

• text:string

  The contents of the string. For quoted strings, this is thesemantic content—any escape sequences that were been written in the sourcetext are resolved to their Unicode values. For unquoted strings, though,escape sequences are preserved as literal backslashes.

• Optionaloptions:{
      quotes?:boolean;
  }

  • Optionalquotes?:boolean

    Whether the string is quoted. Defaults totrue.

Creates an empty string.

Parameters

• Optionaloptions:{
      quotes?:boolean;
  }

  • Optionalquotes?:boolean

    Whether the string is quoted. Defaults totrue.

This value as a list.

All SassScript values can be used as lists. Maps count as lists of pairs,and all other values count as single-value lists.

Whether this value as a list has brackets.

All SassScript values can be used as lists. Maps count as lists of pairs,and all other values count as single-value lists.

Whether this string has quotes.

Whether the value counts astrue in an@if statement and other contexts.

Returns JavaScript'snull value if this issassNull, and returnsthis otherwise.

Sass's notion of this string's length.

Sass treats strings as a series of Unicode code points while JavaScripttreats them as a series ofUTF-16 code units. For example, the characterU+1F60ASMILINGFACEWITHSMILINGEYES is a single Unicode code point butis represented inUTF-16 as two code units (0xD83D and0xDE0A). So inJavaScript,"n😊b".length returns4, whereas in Sassstring.length("n😊b") returns3.

The separator for this value as a list.

All SassScript values can be used as lists. Maps count as lists of pairs,and all other values count as single-value lists.

The contents of the string.

For quoted strings, this is the semantic content—any escape sequences thatwere been written in the source text are resolved to their Unicode values.For unquoted strings, though, escape sequences are preserved as literal backslashes.

This difference allows us to distinguish between identifiers with escapes,such asurl\u28 http://example.com\u29, and unquoted strings that containcharacters that aren't valid in identifiers, such asurl(http://example.com). Unfortunately, it also means that we don'tconsiderfoo andf\6F\6F the same string.

Throws ifthis isn't aSassBoolean.

Parameters

• Optionalname:string

  The name of the function argumentthis came from (withoutthe$) if it came from an argument. Used for error reporting.

Throws ifthis isn't aSassCalculation.

Parameters

• Optionalname:string

  The name of the function argumentthis came from (withoutthe$) if it came from an argument. Used for error reporting.

Throws ifthis isn't aSassColor.

Parameters

• Optionalname:string

  The name of the function argumentthis came from (withoutthe$) if it came from an argument. Used for error reporting.

Throws ifthis isn't aSassFunction.

Parameters

• Optionalname:string

  The name of the function argumentthis came from (withoutthe$) if it came from an argument. Used for error reporting.

Throws ifthis isn't aSassMap.

Parameters

• Optionalname:string

  The name of the function argumentthis came from (withoutthe$) if it came from an argument. Used for error reporting.

Throws ifthis isn't aSassMixin.

Parameters

• Optionalname:string

  The name of the function argumentthis came from (withoutthe$) if it came from an argument. Used for error reporting.

Throws ifthis isn't aSassNumber.

Parameters

• Optionalname:string

  The name of the function argumentthis came from (withoutthe$) if it came from an argument. Used for error reporting.

Throws ifthis isn't aSassString.

Parameters

• Optionalname:string

  The name of the function argumentthis came from (withoutthe$) if it came from an argument. Used for error reporting.

Returns whetherthis represents the same value asother.

Parameters

• other:Value

Returns the value at indexindex in this value as a list, orundefinedifindex isn't valid for this list.

All SassScript values can be used as lists. Maps count as lists of pairs,and all other values count as single-value lists.

This is a shorthand forthis.asList.get(index), although it may be moreefficient in some cases.

Parameters

• index:number

Returns a hash code that can be used to storethis in a hash map.

ConvertssassIndex into a JavaScript-style index into the list returnedbyasList.

Sass indexes are one-based, while JavaScript indexes are zero-based. Sassindexes may also be negative in order to index from the end of the list.

Throws

Error IfsassIndex isn't a number, if that number isn't aninteger, or if that integer isn't a valid index forasList.

Parameters

• sassIndex:Value

  The Sass-style index into this as a list.

• Optionalname:string

  The name of the function argumentsassIndex came from(without the$) if it came from an argument. Used for error reporting.

ConvertssassIndex to a JavaScript index intotext.

Sass indices are one-based, while JavaScript indices are zero-based. Sassindices may also be negative in order to index from the end of the string.

In addition, Sass indices refer to Unicode code points while JavaScriptstring indices refer toUTF-16 code units. For example, the characterU+1F60ASMILINGFACEWITHSMILINGEYES is a single Unicode code point butis represented inUTF-16 as two code units (0xD83D and0xDE0A). So inJavaScript,"n😊b".charCodeAt(1) returns0xD83D, whereas in Sassstring.slice("n😊b", 1, 1) returns"😊".

This function converts Sass's code point indices to JavaScript's code unitindices. This means it's O(n) in the length oftext.

Throws

Error - IfsassIndex isn't a number, if that number isn't aninteger, or if that integer isn't a valid index for this string.

Parameters

• sassIndex:Value

• Optionalname:string

Returnsthis as a map if it counts as one (empty lists count as emptymaps) ornull if it doesn't.