Class HQSL

constructor

• new HQSL(
      fields?: {
          extra?: string;
          freq: number;
          from: string;
          mode: string;
          signal?: string;
          to: string;
          when: UTCDate;
          where: string;
      },
  ): HQSL

  Construct a HQSL from scratch.

  No syntax checking is performed at this stage, though it will happen when anything calls signedData.

  Parameters

  • Optionalfields: {
        extra?: string;
        freq: number;
        from: string;
        mode: string;
        signal?: string;
        to: string;
        when: UTCDate;
        where: string;
    }

    • Optionalextra?: string

      Extra data.

    • freq: number

      Frequency in MHz.

    • from: string

      QSL sender call sign.

    • mode: string

      Communication mode.

    • Optionalsignal?: string

      Signal report.

    • to: string

      QSL recipient call sign.

    • when: UTCDate

      QSO datetime in UTC.

    • where: string

      QSL sender Maidenhead grid location.

  Returns HQSL

Optionalextra

Optionalfreq

Optionalfrom

Optionalmode

Optionalreserved

Optionalsignal

Optionalsignature

Optionalto

Optionalverification

Optionalwhen

Optionalwhere

band

• get band(): string

  Derives an ADIF-standardized band name from frequency.

  Returns string

displayDate

• get displayDate(): string

  Derives a date in a generic ISO-like format for display.

  Returns string

hamDate

• get hamDate(): string

  Derives a datetime formatted as per HQSL standard.

  Returns string

signedData

• get signedData(): string

  Constructs a signable string from the HQSL, throwing SyntaxErrors in case of missing or malformed data fields.

  Returns string

  The entire HQSL as string sans the signature field.

toADIF

• toADIF(): string

  Formats a complete HQSL as an ADIF string. Will contain a fully encoded .toString() in APP_HQSL_DATA.

  Returns string

  A string of a single-QSO ADIF.

toString

• toString(): string

  Formats a complete HQSL as string. Signed HQSLs will contain the encoded signature, while unsigned will have UNSIGNED in the signature field as the standard specifies.

  Returns string

  A string containing the HQSL (sans a header)

StaticfromADIF

• fromADIF(s: string, call: string, grid: string): HQSL[]

  Parses an ADIF file string to construct a series of HQSL. Whether any of it will be signable depends on how complete the ADIF was.

  Parameters

  • s: string

    An ADIF file string.
  • call: string

    The default call to assume if none is present in the record.
  • grid: string

    The default grid to assume if none is present in the record.

  Returns HQSL[]

  Throws

  Error in case of ADIF parsing errors and SyntaxError when data of a QSO is insufficient to construct a valid HQSL.

StaticfromString

• fromString(s: string): HQSL

  Parses a HQSL from string, applying as many verification checks as feasible. Will ignore an URL header if present.

  Parameters

  • s: string

    A string containing the HQSL

  Returns HQSL

  HQSL object

  Throws

  SyntaxError describing a particular parsing error.