Method getValueOrPromise

packages/context/src/context.ts:893–920

* Get the value bound to the given key. * * This is an internal version that preserves the dual sync/async result * of `Binding#getValue()`. Users should use `get()` or `getSync()` instead. * * @example * * ```ts * // get the value bound to "application.instance" * ctx.get

(
    keyWithPath: BindingAddress<ValueType>,
    optionsOrSession?: ResolutionOptionsOrSession,
  )

   * @internal
   */
  getValueOrPromise<ValueType>(
    keyWithPath: BindingAddress<ValueType>,
    optionsOrSession?: ResolutionOptionsOrSession,
  ): ValueOrPromise<ValueType | undefined> {
    const {key, propertyPath} = BindingKey.parseKeyWithPath(keyWithPath);

    const options = asResolutionOptions(optionsOrSession);

    const binding = this.getBinding<ValueType>(key, {optional: true});
    if (binding == null) {
      if (options.optional) return undefined;
      throw new ResolutionError(
        `The key '${key}' is not bound to any value in context ${this.name}`,
        {
          context: this,
          binding: Binding.bind(key),
          options,
        },
      );
    }

    const boundValue = binding.getValue(this, options);
    return propertyPath == null || propertyPath === ''
      ? boundValue
      : transformValueOrPromise(boundValue, v =>
          getDeepProperty<ValueType>(v, propertyPath),
        );
  }

  /**
   * Create a plain JSON object for the context