Insomnia-Script-SDK-Docs
    Preparing search index...

    Class UrlMatchPattern

    Represents the base class for properties. This class provides common functionality for managing hierarchical relationships, metadata, and JSON serialization of properties.

    Hierarchy (View Summary)

    Index

    Constructors

    Properties

    _kind: string = 'PropertyBase'
    _parent: undefined | PropertyBase = undefined

    A reference to the parent property, if any. This allows for hierarchical relationships between properties. If no parent exists, the value will be undefined.

    description?: string

    An optional description providing additional details or context.

    disabled?: boolean

    Indicates whether the property is disabled. When set to true, the property is considered inactive or unavailable.

    id: string = ''

    A unique identifier represented as a string.

    name?: string

    The optional name property. This can be used to specify a name or identifier.

    _index: string = 'id'
    MATCH_ALL_URLS: string = '<all_urls>'
    pattern: undefined | string = undefined
    PROTOCOL_DELIMITER: string = '+'

    Methods

    • Traverses up the parent hierarchy to find an ancestor that contains the specified property. Optionally, a customizer function can be provided to determine if the ancestor should be returned.

      Parameters

      • property: string

        The name of the property to search for in the ancestors.

      • Optionalcustomizer: (ancester: PropertyBase) => boolean

        An optional function that takes an ancestor as input and returns a boolean. If provided, the traversal continues until the customizer returns a truthy value. If not provided, the traversal stops at the first ancestor that contains the property.

      Returns undefined | PropertyBase

      The first ancestor that satisfies the search criteria, or undefined if no such ancestor is found.

    • Iterates through the parent hierarchy of the current object, starting from its immediate parent. The iteration continues until the provided iterator function returns false or there are no more parents.

      Parameters

      • options: { withRoot?: boolean }

        Options to control the iteration behavior.

        • withRoot (optional): A flag to include the root object in the iteration.
      • iterator: (obj: PropertyBase) => boolean

        A callback function that is invoked for each parent object in the hierarchy.

        • The function receives a cloned instance of the parent object as its argument.
        • If the function returns false, the iteration stops.

      Returns undefined | PropertyBase | PropertyBase[]

      An array of cloned parent objects that were iterated over.

    • Determines if a given property key is considered a "meta" property. In the context of Insomnia, meta properties are defined as those that start with an underscore (_). The underscore character itself is also rejected as a valid meta property key.

      Parameters

      • _value: any

        The value associated with the property (currently unused in this method).

      • key: string

        The property key to evaluate.

      Returns boolean | ""

      true if the key starts with an underscore (_), otherwise false.

    • Replaces placeholders in the given content string with values from the provided variables. The placeholders are resolved using an interpolation mechanism, and the variables are merged in reverse order to determine the final context for substitution.

      Parameters

      • content: string

        The string containing placeholders to be replaced.

      • ...variables: object[]

        A list of objects containing key-value pairs for substitution. The objects are merged in reverse order to form the final context.

      Returns string

      The content string with placeholders replaced by corresponding values from the context.

      If the content parameter is not a string or if variables is not an array.

    • Replaces substitutions in the given object using the provided variables.

      This method takes an object and a list of variable objects, and replaces placeholders in the object with corresponding values from the variables. The variables are merged in reverse order, meaning the last variable in the list has the highest priority.

      Parameters

      • obj: object

        The object containing placeholders to be replaced.

      • ...variables: object[]

        A list of objects containing substitution values.

      Returns object

      A new object with substitutions replaced.

      If the first parameter is not an object or if the variables are not provided as an array.

      If an error occurs during the substitution process.