node-datachannel/src/polyfill/RTCIceCandidate.ts

WebRTC For Node.js and Electron. libdatachannel node bindings.

// https://developer.mozilla.org/docs/Web/API/RTCIceCandidate
//
// Example: candidate:123456 1 UDP 123456 192.168.1.1 12345 typ host raddr=10.0.0.1 rport=54321 generation 0


export default class RTCIceCandidate implements globalThis.RTCIceCandidate {
    #address: string | null;
    #candidate: string;
    #component: globalThis.RTCIceComponent | null;
    #foundation: string | null;
    #port: number | null;
    #priority: number | null;
    #protocol: globalThis.RTCIceProtocol | null;
    #relatedAddress: string | null;
    #relatedPort: number | null;
    #sdpMLineIndex: number | null;
    #sdpMid: string | null;
    #tcpType: globalThis.RTCIceTcpCandidateType | null;
    #type: globalThis.RTCIceCandidateType | null;
    #usernameFragment: string | null;

    constructor({ candidate, sdpMLineIndex, sdpMid, usernameFragment }: globalThis.RTCIceCandidateInit) {
        if (sdpMLineIndex == null && sdpMid == null)
            throw new TypeError('At least one of sdpMLineIndex or sdpMid must be specified');

        this.#candidate = candidate === null ? 'null' : candidate ?? '';
        this.#sdpMLineIndex = sdpMLineIndex ?? null;
        this.#sdpMid = sdpMid ?? null;
        this.#usernameFragment = usernameFragment ?? null;

        if (candidate) {
            const fields = candidate.split(' ');
            this.#foundation = fields[0].replace('candidate:', ''); // remove text candidate:
            this.#component = fields[1] == '1' ? 'rtp' : 'rtcp';
            this.#protocol = fields[2] as globalThis.RTCIceProtocol;
            this.#priority = parseInt(fields[3], 10);
            this.#address = fields[4];
            this.#port = parseInt(fields[5], 10);
            this.#type = fields[7] as globalThis.RTCIceCandidateType;
            this.#tcpType = null;
            this.#relatedAddress = null;
            this.#relatedPort = null;

            // Parse the candidate string to extract relatedPort and relatedAddress
            for (let i = 8; i < fields.length; i++) {
                const field = fields[i];
                if (field === 'raddr') {
                    this.#relatedAddress = fields[i + 1];
                } else if (field === 'rport') {
                    this.#relatedPort = parseInt(fields[i + 1], 10);
                }

                if (this.#protocol === 'tcp' && field === 'tcptype') {
                    this.#tcpType = fields[i + 1] as globalThis.RTCIceTcpCandidateType;
                }
            }
        }
    }

    get address(): string | null {
        return this.#address || null;
    }

    get candidate(): string {
        return this.#candidate;
    }

    get component(): globalThis.RTCIceComponent | null {
        return this.#component;
    }

    get foundation(): string | null {
        return this.#foundation || null;
    }

    get port(): number | null {
        return this.#port || null;
    }

    get priority(): number | null {
        return this.#priority || null;
    }

    get protocol(): globalThis.RTCIceProtocol | null {
        return this.#protocol || null;
    }

    get relatedAddress(): string | null {
        return this.#relatedAddress;
    }

    get relatedPort(): number | null {
        return this.#relatedPort || null;
    }

    get sdpMLineIndex(): number | null {
        return this.#sdpMLineIndex;
    }

    get sdpMid(): string | null {
        return this.#sdpMid;
    }

    get tcpType(): globalThis.RTCIceTcpCandidateType | null {
        return this.#tcpType;
    }

    get type(): globalThis.RTCIceCandidateType | null {
        return this.#type || null;
    }

    get usernameFragment(): string | null {
        return this.#usernameFragment;
    }

    toJSON(): globalThis.RTCIceCandidateInit {
        return {
            candidate: this.#candidate,
            sdpMLineIndex: this.#sdpMLineIndex,
            sdpMid: this.#sdpMid,
            usernameFragment: this.#usernameFragment,
        };
    }
}