html-table-to-dataframe/dist/table-shared.js

Convert HTML tables to data-frames

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.generateHeaders = generateHeaders;
exports.validateHeaders = validateHeaders;
exports.buildData = buildData;
/**
 * Generates an array of header names from the table's thead section.
 * If a header element's text content is empty, it will be replaced with a unique identifier
 * in the format 'unknownX', where X is the number of missing headers encountered so far.
 *
 * @param {Document} document - The document object where the table resides.
 * @returns {string[]} - An array of header names, with empty headers replaced by 'unknownX'.
 */
function generateHeaders(document) {
    const headerElements = Array.from(document.querySelectorAll('table thead th'));
    let unknownCount = 0;
    return headerElements.map((th) => {
        var _a;
        const text = (_a = th.textContent) === null || _a === void 0 ? void 0 : _a.trim();
        if (text && text !== '') {
            return text;
        }
        else {
            return `Unknown${unknownCount++}`;
        }
    });
}
/**
 * Validates the provided headers against the number of columns in the table.
 * Throws an error if the lengths do not match.
 *
 * @param headers - The headers provided by the user.
 * @param document - The HTML document containing the table.
 */
function validateHeaders(headers, document) {
    const columnCount = document.querySelectorAll('table thead th').length;
    if (headers.length !== columnCount) {
        throw new Error(`The number of provided headers (${headers.length}) does not match the number of columns in the table (${columnCount}).`);
    }
}
/**
 * Transforms a 2D array of data rows into an array of objects, where each object
 * represents a row with keys corresponding to the provided headers.
 *
 * @param rows - A 2D array where each sub-array represents a row of data.
 * @param headers - An array of strings where each string represents a column header.
 * @returns An array of objects where each object represents a row, with keys derived from the headers
 *          and values from the rows.
 *
 * @example
 * const headers = ["Name", "Age", "Occupation"];
 * const rows = [
 *   ["Alice", 30, "Engineer"],
 *   ["Bob", 25, "Designer"]
 * ];
 *
 * const result = buildData(rows, headers);
 * // result will be:
 * // [
 * //   { Name: "Alice", Age: 30, Occupation: "Engineer" },
 * //   { Name: "Bob", Age: 25, Occupation: "Designer" }
 * // ]
 */
function buildData(rows, headers) {
    // Build the array of data
    const tableData = rows.map((row) => row.reduce((rowData, cell, index) => {
        rowData[headers[index]] = cell;
        return rowData;
    }, {}));
    return tableData;
}