Class DocumentPath

Represents a portion of the document at a specific key-path.

Provides an interface to specify a path to a key in a document that you can then call a function on to get the value at the specified key as a specific type. You don't create a DocumentPath directly but obtain one via the path property or the at() method of Document.

Hierarchy

  • DocumentPath

Properties

Accessors

Methods

Properties

document: Document

The document this path belongs to.

path: string

The full document path so far.

Accessors

  • get counter(): Counter
  • Returns the value at the previously specified key in the document as a Counter if possible, otherwise returns null.

    Returns Counter

  • get register(): Register
  • Returns the value at the previously specified key in the document as a Register if possible, otherwise returns null.

    Returns Register

  • get rga(): RGA
  • Returns the value at the previously specified key in the document as an RGA if possible, otherwise returns null.

    @deprecated: RGA usage should be replaced. Use arrays inside Registers instead.

    Returns RGA

  • get value(): any
  • Traverses the document with the key-path represented by the receiver and returns the corresponding object or value.

    Returns any

Methods

  • Returns a new document path instance with the passed in key-path or index appended.

    A key-path can be a single property name or multiple property names separated by a dot. Indexes can also be specified as part of the key path using the square bracket syntax. The empty string returns a document path representing the same portion of the document as the receiver. If a key-path starts with a property name and is prefixed by a dot, the dot is ignored.

    Examples:

    • documentPath.at('mileage')
    • documentPath.at('driver.name')
    • documentPath.at('passengers[2]')
    • documentPath.at('passengers[2].belongings[1].kind')
    • documentPath.at('.mileage')

    Parameters

    • keyPathOrIndex: string | number

    Returns DocumentPath