Class HQSL

constructor

• new HQSL(fields?): HQSL

• Construct a HQSL from scratch.

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

  Parameters

  • Optional fields: {
        extra?: string;
        freq: number;
        from: string;
        mode: string;
        signal?: string;
        to: string;
        when: UTCDateMini;
        where: string;
    }

    • Optional extra?: string

      Extra data.

    • freq: number

      Frequency in MHz.

    • from: string

      QSL sender call sign.

    • mode: string

      Communication mode.

    • Optional signal?: string

      Signal report.

    • to: string

      QSL recipient call sign.

    • when: UTCDateMini

      QSO datetime in UTC.

    • where: string

      QSL sender Maidenhead grid location.

  Returns HQSL

Optional extra

Optional freq

Optional from

Optional mode

Optional reserved

Optional signal

Optional signature

Optional to

Optional verification

Optional when

Optional where

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)

Static fromADIF

• fromADIF(s, call, grid): 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.

Static fromString

• fromString(s): 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.