Function joinPropertyPath

  • Converts a property path to an equivalent dotted string path when that conversion is lossless.

    Exact property-key arrays containing numbers, symbols, or string segments with literal periods cannot be represented by dotted-string syntax without changing their property-path semantics and are rejected. Empty segments are retained, so ['level1', '', 'value'] becomes 'level1..value'. The exact single empty-string key [''] is rejected because an empty dotted string is not a valid PropertyPath.

    Parameters

    Returns string

    An equivalent dotted string property path.

    If path is invalid or cannot be represented losslessly as a dotted string property path.