craftping/src/Query/QueryClient.js

A universal ping/query library for Minecraft servers.

import Query from "./Query.js";
import SharedUDPSocket from "../UDPSocket/SharedUDPSocket.js";

export default class QueryClient extends SharedUDPSocket {
    /**
     * @param {string} address
     * @param {number} port
     * @param {?AbortSignal} signal
     * @param {?boolean} useLegacyStringEncoding
     * @return {Promise<BasicStatResponse>}
     */
    async queryBasic(address, port, signal = null, useLegacyStringEncoding = null) {
        let query = new Query(address, port, this, signal);
        await query.connect();
        let result;
        try {
            result = await query.queryBasic(useLegacyStringEncoding);
        } catch (e) {
            query.close();
            throw e;
        }
        query.close();
        return result;
    }

    /**
     * @param {string} address
     * @param {number} port
     * @param {?AbortSignal} signal
     * @param {?boolean} useLegacyStringEncoding
     * @return {Promise<FullStatResponse>}
     */
    async queryFull(address, port, signal = null, useLegacyStringEncoding = null) {
        let query = new Query(address, port, this, signal);
        await query.connect();
        let result;
        try {
            result = await query.queryFull(useLegacyStringEncoding);
        } catch (e) {
            query.close();
            throw e;
        }
        query.close();
        return result;
    }
}