Method parse

packages/foam-core/src/model/uri.ts:58–78

* Parses a string value into a URI object. * @param value the string value of the URI * @param defaultScheme the default scheme to use if none is provided in the value. * - if a `string`, it will be used as the default scheme * - if a `URI`, its scheme will be used as the default scheme

(value: string, defaultScheme: URI | string | null)

   * @throws if no scheme is provided in value and no default scheme is given
   */
  static parse(value: string, defaultScheme: URI | string | null): URI {
    const match = _regexp.exec(value);
    if (!match) {
      return new URI();
    }
    defaultScheme =
      defaultScheme instanceof URI
        ? defaultScheme.scheme
        : (defaultScheme as string | null);
    const scheme = match[2] || defaultScheme;
    if (isNone(scheme)) {
      throw new Error(`Invalid URI: The URI scheme is missing: ${value}`);
    }
    return new URI({
      scheme,
      authority: percentDecode(match[4] ?? _empty),
      path: pathUtils.fromFsPath(percentDecode(match[5] ?? _empty))[0],
      query: percentDecode(match[7] ?? _empty),
      fragment: percentDecode(match[9] ?? _empty),
    });
  }

  /**
   * @deprecated Will not work with web extension. Use only for testing.