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