Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface ScalarTag

Hierarchy

  • TagBase
    • ScalarTag

Index

Properties

Methods

Properties

Optional collection

collection?: undefined

Optional default

default?: boolean

If true, together with test allows for values to be stringified without an explicit tag. For most cases, it's unlikely that you'll actually want to use this, even if you first think you do.

Optional format

format?: string

If a tag has multiple forms that should be parsed and/or stringified differently, use format to identify them.

Optional nodeClass

nodeClass?: undefined

tag

tag: string

The identifier for your data type, with which its stringified form will be prefixed. Should either be a !-prefixed local !tag, or a fully qualified tag:domain,date:foo.

Optional test

test?: RegExp

Together with default allows for values to be stringified without an explicit tag and detected using a regular expression. For most cases, it's unlikely that you'll actually want to use these, even if you first think you do.

Methods

Optional createNode

  • createNode(schema: yaml.Schema, value: unknown, ctx: CreateNodeContext): yaml.Node<unknown>

  • An optional factory function, used e.g. by collections when wrapping JS objects as AST nodes.

    Parameters

    • schema: yaml.Schema
    • value: unknown
    • ctx: CreateNodeContext

    Returns yaml.Node<unknown>

Optional identify

  • identify(value: unknown): boolean

  • Used by YAML.createNode to detect your data type, e.g. using typeof or instanceof.

    Parameters

    • value: unknown

    Returns boolean

resolve

  • resolve(value: string, onError: (message: string) => void, options: ParseOptions): unknown

  • Turns a value into an AST node. If returning a non-Node value, the output will be wrapped as a Scalar.

    Parameters

    • value: string
    • onError: (message: string) => void
        • (message: string): void

        • Parameters

          • message: string

          Returns void

    • options: ParseOptions

    Returns unknown

Optional stringify

  • stringify(item: Scalar<unknown>, ctx: StringifyContext, onComment?: () => void, onChompKeep?: () => void): string

  • Optional function stringifying a Scalar node. If your data includes a suitable .toString() method, you can probably leave this undefined and use the default stringifier.

    Parameters

    • item: Scalar<unknown>

      The node being stringified.

    • ctx: StringifyContext

      Contains the stringifying context variables.

    • Optional onComment: () => void

      Callback to signal that the stringifier includes the item's comment in its output.

        • (): void

        • Returns void

    • Optional onChompKeep: () => void

      Callback to signal that the output uses a block scalar type with the + chomping indicator.

        • (): void

        • Returns void

    Returns string

Generated using TypeDoc