vcard4/src/parameters/MediatypeParameter.js

An RFC 6350 compliant JavaScript library for generating and parsing version 4.0 vCards. Can also generate RFC 6351 compliant XML vCards and RFC 7095 compliant jCards. TypeScript type declarations are provided.

import { BaseParameter } from "./BaseParameter.js";
import { MissingArgument, InvalidArgument } from "../errors/index.js";

export class MediatypeParameter extends BaseParameter {
  static param = "MEDIATYPE";
  static identifier = "MediatypeParameter";

  #mediaTypeRegExp =
    /^(?:[A-Za-z0-9!#\$&\.\+\-\^_]){1,127}\/(?:[A-Za-z0-9!#\$&\.\+\-\^_]){1,127}$/;
  #attributeRegExp = /^[A-Za-z0-9!#\$&\.\+\-\^_]+=[A-Za-z0-9!#\$&\.\+\-\^_]+$/;
  #mediaValue;

  get value() {
    return Array.isArray(this.#mediaValue)
      ? `"${this.#mediaValue.map((val) => val.repr()).join(";")}"`
      : this.#mediaValue.repr();
  }

  get valueXML() {
    return Array.isArray(this.#mediaValue)
      ? "<text>" +
          this.#mediaValue
            .map((val) => val.reprXML())
            .join(";")
            .replace(/<\/?text>/g, "") +
          "</text>"
      : this.#mediaValue.reprXML();
  }

  get valueJSON() {
    if (Array.isArray(this.#mediaValue))
      return [
        "text",
        this.#mediaValue.map((val) => val._unsafe_raw_value).join(";"),
      ];

    return this.#mediaValue.reprJSON();
  }

  #validate(mediaValue) {
    if (typeof mediaValue === "undefined")
      throw new MissingArgument(
        "Value for MediatypeParameter must be supplied"
      );
    else if (
      (!Array.isArray(mediaValue) &&
        mediaValue.constructor.identifier !== "ParameterValueType") ||
      (Array.isArray(mediaValue) &&
        !mediaValue.every(
          (val) => val.constructor.identifier === "ParameterValueType"
        ))
    )
      throw new TypeError(
        "Value for MediatypeParameter must be of ParameterValueType or an array of ParameterValueTypes"
      );
    else if (
      !Array.isArray(mediaValue) &&
      !this.#mediaTypeRegExp.test(mediaValue.repr())
    )
      throw new InvalidArgument("Invalid media type");
    else if (Array.isArray(mediaValue)) {
      if (mediaValue.length !== 2)
        throw new InvalidArgument(
          "Invalid value for MediatypeParameter. It should be an array with a length of 2"
        );
      else if (!this.#mediaTypeRegExp.test(mediaValue[0].repr()))
        throw new InvalidArgument("Invalid media type");
      else if (!this.#attributeRegExp.test(mediaValue[1].repr()))
        throw new InvalidArgument("Invalid media type");
    }
  }

  constructor(mediaValue) {
    super();

    this.#validate(mediaValue);
    this.#mediaValue = mediaValue;

    this.checkAbstractPropertiesAndMethods();
    Object.freeze(this);
  }
}

Object.freeze(MediatypeParameter);