Get Top Speed Test Locations

type Cloudflare = {

  token: string;

  email: string;

  key: string;

};

/**

 * Get Top Speed Test Locations

 * Get the top locations by bandwidth, latency, jitter or packet loss, from the previous 90 days of Cloudflare Speed Test data.

 */

export async function main(

  auth: Cloudflare,

  limit: string | undefined,

  name: string | undefined,

  dateEnd: string | undefined,

  asn: string | undefined,

  location: string | undefined,

  orderBy:

    | "BANDWIDTH_DOWNLOAD"

    | "BANDWIDTH_UPLOAD"

    | "LATENCY_IDLE"

    | "LATENCY_LOADED"

    | "JITTER_IDLE"

    | "JITTER_LOADED"

    | undefined,

  reverse: string | undefined,

  format: "JSON" | "CSV" | undefined

) {

  const url = new URL(

    `https://api.cloudflare.com/client/v4/radar/quality/speed/top/locations`

  );

  for (const [k, v] of [

    ["limit", limit],

    ["name", name],

    ["dateEnd", dateEnd],

    ["asn", asn],

    ["location", location],

    ["orderBy", orderBy],

    ["reverse", reverse],

    ["format", format],

  ]) {

    if (v !== undefined && v !== "") {

      url.searchParams.append(k, v);

    }

  }

  const response = await fetch(url, {

    method: "GET",

    headers: {

      "X-AUTH-EMAIL": auth.email,

      "X-AUTH-KEY": auth.key,

      Authorization: "Bearer " + auth.token,

    },

    body: undefined,

  });

  if (!response.ok) {

    const text = await response.text();

    throw new Error(`${response.status} ${text}`);

  }

  return await response.json();

}