spothole/webassets/js/code.js

// How often to query the server?
const REFRESH_INTERVAL_SEC = 60;

// Storage for the spot data that the server gives us.
var spots = []
// Storage for the options that the server gives us. This will define our filters.
var options = {};
// Last time we updated the spots list on display.
var lastUpdateTime;
// Options-based lookups for band colours
band_colors = {}

// Load spots and populate the table.
function loadSpots() {
    $.getJSON('/api/spots', function(jsonData) {
        // Store last updated time
        lastUpdateTime = moment.utc();
        updateRefreshDisplay();
        // Store data
        spots = jsonData;
        // Update table
        updateTable();
    });
}

// Update the spots table
function updateTable() {
    // Populate table with headers
    let headers = Object.keys(spots[0]);
    let table = $('<table class="table table-striped table-hover">').append('<thead><tr class="table-primary"></tr></thead><tbody></tbody>');
    ["UTC", "DX", "Frequency", "Mode", "Comment", "Source", "Ref.", "DE"].forEach(header => table.find('thead tr').append(`<th>${header}</th>`));

    spots.forEach(s => {
        // Create row
        let $tr = $('<tr>');

        // Show in red if QRT
        if (s["qrt"] == true) {
          $tr.addClass("table-faded");
        }

        // Format a UTC time for display
        var time = moment.utc(s["time"], moment.ISO_8601);
        var time_formatted = time.format("HH:mm")

        // Format dx country
        var dx_country = s["dx_country"]
        if (dx_country == null) {
            dx_country = "Unknown or not a country"
        }

        // Format the frequency
        var mhz = Math.floor(s["freq"] / 1000.0);
        var khz = Math.floor(s["freq"] - (mhz * 1000.0));
        var hz = Math.floor((s["freq"] - Math.floor(s["freq"])) * 1000.0);
        var hz_string = (hz > 0) ? hz.toFixed(0) : "";
        var freq_string = `<span class='freq-mhz'>${mhz.toFixed(0)}</span><span class='freq-khz'>${khz.toFixed(0).padStart(3, '0')}</span><span class='freq-hz'>${hz_string}</span>`

        // Format the mode
        mode_string = s["mode"];
        if (s["mode_source"] == "BANDPLAN") {
            mode_string = mode_string + "<span class='mode-q'><i class='fa-solid fa-circle-question' title='The mode was not reported via the spotting service. This is a guess based on the frequency.'></i></span>"
        }

        // Band-based colour
        var band_dot_style = ""
        if (band_colors[s["band"]]) {
            band_dot_style = `color: ${band_colors[s["band"]]}; `
        }

        // Format sig_refs
        var sig_refs = ""
        if (s["sig_refs"]) {
            sig_refs = s["sig_refs"].join(", ")
        }

        // Format DE flag
        var de_flag = "<i class='fa-solid fa-circle-question'></i>";
        if (s["de_flag"] && s["de_flag"] != "") {
            de_flag = s["de_flag"];
        }

        // Format de country
        var de_country = s["de_country"]
        if (de_country == null) {
            de_country = "Unknown or not a country"
        }

        // Populate the row
        $tr.append(`<td>${time_formatted}</td>`);
        $tr.append(`<td><span class='flag-wrapper' title='${dx_country}'>${s["dx_flag"]}</span>${s["dx_call"]}</td>`);
        $tr.append(`<td><span class='band-dot' style='${band_dot_style}'>&#9632;</span>${freq_string}</td>`);
        $tr.append(`<td>${mode_string}</td>`);
        $tr.append('<td>' + escapeHtml(`${s["comment"]}`) + '</td>');
        $tr.append(`<td><span class='icon-wrapper'><i class='fa-solid fa-${s["icon"]}'></i></span> ${s["source"]}</td>`);
        $tr.append(`<td>${sig_refs}</td>`);
        $tr.append(`<td><span class='flag-wrapper' title='${de_country}'>${de_flag}</span>${s["de_call"]}</td>`);
        table.find('tbody').append($tr);
    });

    // Update DOM
    $('#table-container').html(table);
}

// Load server status
function loadStatus() {
    $.getJSON('/api/status', function(jsonData) {
        $('#status-container').html(jsonData); // todo implement
    });
}

// Load server options. Once a successful callback is made from this, we then query spots and set up the timer to query
// spots repeatedly.
function loadOptions() {
    $.getJSON('/api/options', function(jsonData) {
        // Store options
        options = jsonData;

        // Separately store colour lookups for bands
        options["bands"].forEach(m => {
            band_colors[m["name"]] = m["color"]
        });

        // Load spots and set up the timer
        loadSpots();
        setInterval(loadSpots, REFRESH_INTERVAL_SEC * 1000)
    });
}

// Update the refresh timing display
function updateRefreshDisplay() {
    if (lastUpdateTime != null) {
        let count = REFRESH_INTERVAL_SEC;
        let secSinceUpdate = moment.duration(moment().diff(lastUpdateTime)).asSeconds();
        updatingString = "Updating..."
        if (secSinceUpdate < REFRESH_INTERVAL_SEC) {
            count = REFRESH_INTERVAL_SEC - secSinceUpdate;
            updatingString = "Updating in " + count.toFixed(0) + " seconds...";
        }
        $("#timing-container").text("Last updated at " + lastUpdateTime.format('HH:mm') + " UTC. " + updatingString);
    }
}

// Utility function to escape HTML characters from a string.
function escapeHtml(str) {
    if (typeof str !== 'string') {
        return '';
    }

    const escapeCharacter = (match) => {
        switch (match) {
            case '&': return '&amp;';
            case '<': return '&lt;';
            case '>': return '&gt;';
            case '"': return '&quot;';
            case '\'': return '&#039;';
            case '`': return '&#096;';
            default: return match;
        }
    };

    return str.replace(/[&<>"'`]/g, escapeCharacter);
}


// Startup. Call loadOptions(), this will then trigger loading spots and setting up timers.
loadOptions();
// Update the refresh timing display every second
setInterval(updateRefreshDisplay, 1000);