rfheadless 0.1.0

A headless browsing engine API for Rust
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
/// Quick note about this file:
/// This file was made entirely by AI as I suck as javascript
/// So please be kind when reviewing it :)

var __rfox_dom = (typeof __RFOX_ELEMENTS__ !== 'undefined' ? __RFOX_ELEMENTS__ : []);

function __matches_simple(el, sel) {
    if (!sel) return false;
    if (sel[0] === '#') return el.id === sel.slice(1);
    if (sel[0] === '.') return (el.class||'').split(/\s+/).indexOf(sel.slice(1)) !== -1;
    // attribute selectors with optional operators: = ~= ^= $= *= |=
    var attrm = sel.match(/^\[([^~|\^\$\*=\]]+)(?:([~\^\$\*\|]?=)\s*(?:['\"]?([^'\"]+)['\"]?)\s*)?\]$/);
    if (attrm) {
        var name = attrm[1].trim();
        var op = attrm[2];
        var val = attrm[3];
        var aval = el.getAttribute(name);
        if (op === undefined) return aval !== null;
        if (aval === null) return false;
        if (op === '=') return aval === val;
        if (op === '~=') return (aval.split(/\s+/).indexOf(val) !== -1);
        if (op === '^=') return aval.indexOf(val) === 0;
        if (op === '$=') return aval.indexOf(val, aval.length - val.length) !== -1;
        if (op === '*=') return aval.indexOf(val) !== -1;
        if (op === '|=') return (aval === val || aval.indexOf(val + '-') === 0);
        return false;
    }
    // pseudo-classes: :first-child, :last-child
    var pc = sel.match(/:([a-z-]+)$/);
    var pcname = null;
    if (pc) {
        pcname = pc[1];
        sel = sel.replace(/:[a-z-]+$/, '');
        sel = sel.trim();
    }
    if (pcname) {
        var idx = __rfox_dom.indexOf(el);
        if (idx === -1) { return false; }
        var parent = el.parent;
        var siblings = [];
        for (var si=0; si<__rfox_dom.length; si++) { if (__rfox_dom[si].parent === parent) siblings.push(si); }
        if (pcname === 'first-child') {
            if (siblings.length === 0) return false;
            if (siblings[0] !== idx) return false;
        }
        if (pcname === 'last-child') {
            if (siblings.length === 0) return false;
            if (siblings[siblings.length-1] !== idx) return false;
        }
    }
    var parts = sel.split('.');
    if (parts.length === 2) return el.tag.toLowerCase() === parts[0].toLowerCase() && (el.class||'').split(/\s+/).indexOf(parts[1]) !== -1;
    return el.tag.toLowerCase() === sel.toLowerCase();
}

function __matches(el, selector) {
    selector = selector.trim();
    // Fast path for simple selectors
    if (selector.indexOf(' ') === -1 && selector.indexOf('>') === -1) {
        return __matches_simple(el, selector);
    }
    // Complex selector: right-to-left matching
    var tokens = selector.split(/\s+/);
    var cur = el;
    var i = tokens.length - 1;
    while (i >= 0) {
        var token = tokens[i];
        if (token === '>') {
            i--;
            if (i < 0) return false;
            var sel = tokens[i];
            var pidx = cur.parent;
            if (pidx === null || pidx === undefined) return false;
            var parent = __rfox_dom[pidx];
            if (!__matches_simple(parent, sel)) return false;
            cur = parent;
            i--;
            continue;
        } else {
            var sel = token;
            // For descendant combinator, find an ancestor matching sel
            var pidx = cur.parent;
            var found = false;
            // Right-most token may refer to the element itself
            if (i === tokens.length - 1 && __matches_simple(cur, sel)) { i--; continue; }
            while (pidx !== null && pidx !== undefined) {
                var ancestor = __rfox_dom[pidx];
                if (__matches_simple(ancestor, sel)) { found = true; cur = ancestor; break; }
                pidx = ancestor.parent;
            }
            if (!found) return false;
            i--;
            continue;
        }
    }
    return true;
}

function querySelector(sel) {
    var parts = sel.split(',').map(function(s){return s.trim();});
    for (var i=0;i<__rfox_dom.length;i++) {
        for (var pi=0; pi<parts.length; pi++) {
            if (__matches(__rfox_dom[i], parts[pi])) return __wrap_el(__rfox_dom[i]);
        }
    }
    return __wrap_el(null);
}

function querySelectorAll(sel) {
    var out = [];
    var parts = sel.split(',').map(function(s){return s.trim();});
    for (var i=0;i<__rfox_dom.length;i++) {
        for (var pi=0; pi<parts.length; pi++) {
            if (__matches(__rfox_dom[i], parts[pi])) out.push(__wrap_el(__rfox_dom[i]));
        }
    }
    return out;
}

// Wrap element with safe helpers to avoid TypeErrors.
function __wrap_el(el) {
    if (!el) {
        return { text: "", id: "", class: "", tag: "", attributes: [], getAttribute: function() { return null; }, textContent: function() { return ""; }, innerHTML: function(v) { if (arguments.length) { this.text = v; } return (this.text === undefined || this.text === null) ? "" : this.text; } };
    }
    if (!el.getAttribute) {
        el.getAttribute = function(n) {
            for (var i=0;i<this.attributes.length;i++) { if (this.attributes[i][0] === n) return this.attributes[i][1]; }
            return null;
        };
    }
    if (!el.setAttribute) {
        el.setAttribute = function(n, v) {
            for (var i=0;i<this.attributes.length;i++) { if (this.attributes[i][0] === n) { this.attributes[i][1] = String(v); return; } }
            this.attributes.push([n, String(v)]);
            // keep dataset in sync if data-* attribute
            if (n.indexOf('data-') === 0 && this.dataset) {
                var name = n.slice(5).replace(/-([a-z])/g,function(m,p){return p.toUpperCase();});
                try { this.dataset[name] = String(v); } catch(e) {}
            }
        };
    }
    if (!el.textContent) {
        el.textContent = function() { return (this.text === undefined || this.text === null) ? "" : this.text; };
    }
    if (!el.innerHTML) {
        el.innerHTML = function(v) { if (arguments.length) { this.text = v; } return (this.text === undefined || this.text === null) ? "" : this.text; };
    }
    // dataset: expose data-* attributes as camelCase props and helpers
    if (!el.dataset) {
        el.dataset = (function(e) { var out = {}; for (var i=0;i<e.attributes.length;i++) { var k=e.attributes[i][0]; if (k.indexOf('data-')===0) { var name = k.slice(5).replace(/-([a-z])/g,function(m,p){return p.toUpperCase();}); out[name]=e.attributes[i][1]; } } out.get = function(n) { return out[n] || null; }; out.set = function(n, v) { try { e.setAttribute('data-' + n.replace(/([A-Z])/g, function(m,p){return '-' + p.toLowerCase();}), String(v)); out[n] = String(v); } catch(e) {} }; return out; })(el);
    }
    // classList helper with add/remove/toggle/contains and helpers
    if (!el.classList) {
        el.classList = (function(e) {
            return {
                add: function(c) { var parts = (e.class||'').split(/\s+/).filter(Boolean); if (parts.indexOf(c)===-1) { parts.push(c); e.class=parts.join(' '); e.setAttribute('class', e.class); } },
                remove: function(c) { var parts = (e.class||'').split(/\s+/).filter(Boolean); e.class = parts.filter(function(p){return p!==c;}).join(' '); e.setAttribute('class', e.class); },
                toggle: function(c) { if (this.contains(c)) this.remove(c); else this.add(c); },
                contains: function(c) { return (e.class||'').split(/\s+/).indexOf(c)!==-1; },
                length: function() { return (e.class||'').split(/\s+/).filter(Boolean).length; },
                toString: function() { return (e.class||'').trim(); }
            };
        })(el);
    }
    if (!el.querySelector) {
        el.querySelector = function(sel) { for (var i=0;i<__rfox_dom.length;i++) { if (__matches(__rfox_dom[i], sel)) return __wrap_el(__rfox_dom[i]); } return __wrap_el(null); };
    }
    if (!el.querySelectorAll) {
        el.querySelectorAll = function(sel) { var out=[]; for (var i=0;i<__rfox_dom.length;i++) { if (__matches(__rfox_dom[i], sel)) out.push(__wrap_el(__rfox_dom[i])); } return out; };
    }
    return el;
}


// Snapshot helper useful for debugging and tests
function __rfox_snapshot() {
    try {
        return JSON.stringify({ dom: __rfox_dom, styles: __rfox_styles, now: __rfox_now, macrotasks: __rfox_macrotasks.map(function(m){ return { id: m.id, due: m.due, interval: m.interval }; }) });
    } catch(e) { return ''; }
}

// Simple CSS parser: populate __rfox_rules from document.styles
var __rfox_styles = (typeof __RFOX_STYLES__ !== 'undefined' ? __RFOX_STYLES__ : []);
var __rfox_rules = [];
(function() {
    var rule_re = /([^\{]+)\{([^\}]+)\}/g;
    function computeSpec(sel) {
        var idc = (sel.match(/#[\w-]+/g) || []).length;
        var clc = ((sel.match(/\.[\w-]+/g) || []).length) + ((sel.match(/\[[^\]]+\]/g) || []).length);
        var tagc = (sel.replace(/#[\w-]+/g, '').replace(/\.[\w-]+/g, '').replace(/\[[^\]]+\]/g, '').trim().match(/[a-zA-Z][\w-]*/g) || []).length;
        return idc * 10000 + clc * 100 + tagc;
    }
    for (var si=0; si<__rfox_styles.length; si++) {
        var s = __rfox_styles[si];
        var m;
        while ((m = rule_re.exec(s)) !== null) {
            var sels = m[1].trim().split(',');
            var decls = {};
            m[2].split(';').forEach(function(d) {
                var parts = d.split(':');
                if (parts.length === 2) { decls[parts[0].trim()] = parts[1].trim(); }
            });
            sels.forEach(function(subsel) {
                var rs = subsel.trim();
                var spec = computeSpec(rs);
                __rfox_rules.push({ selector: rs, decls: decls, specificity: spec, order: __rfox_rules.length });
            });
        }
    }
})();

// Normalization helpers for computed styles (extended)
function normalizeColor(val) {
    if (!val) return val;
    val = String(val).trim().toLowerCase();
    var hexm = val.match(/^#([0-9a-f]{3}|[0-9a-f]{6})$/);
    if (hexm) {
        var h = hexm[1];
        if (h.length === 3) {
            h = h.split('').map(function(c){return c+c}).join('');
        }
        return '#' + h;
    }
    var rgbm = val.match(/^rgba?\(([^)]+)\)$/);
    if (rgbm) {
        var parts = rgbm[1].split(',').map(function(p){return p.trim();});
        var r = parseInt(parts[0])||0;
        var g = parseInt(parts[1])||0;
        var b = parseInt(parts[2])||0;
        var a = parts[3] !== undefined ? parseFloat(parts[3]) : 1;
        if (a >= 1) {
            return '#' + [r,g,b].map(function(n){ return ('0'+(n&255).toString(16)).slice(-2); }).join('');
        } else {
            return 'rgba(' + [r,g,b,a].join(',') + ')';
        }
    }
    // hsl/hsla -> rgb -> hex/rgba
    var hslm = val.match(/^hsla?\(([^)]+)\)$/);
    if (hslm) {
        var parts = hslm[1].split(',').map(function(p){return p.trim();});
        var h = parseFloat(parts[0]) || 0;
        var s = (parts[1]||'0').replace('%',''); s = parseFloat(s)/100 || 0;
        var l = (parts[2]||'0').replace('%',''); l = parseFloat(l)/100 || 0;
        var a = parts[3] !== undefined ? parseFloat(parts[3]) : 1;
        function hue2rgb(p, q, t) {
            if (t < 0) t += 1;
            if (t > 1) t -= 1;
            if (t < 1/6) return p + (q - p) * 6 * t;
            if (t < 1/2) return q;
            if (t < 2/3) return p + (q - p) * (2/3 - t) * 6;
            return p;
        }
        var r,g,b;
        if (s === 0) { r = g = b = l; }
        else {
            var q = l < 0.5 ? l * (1 + s) : l + s - l * s;
            var p = 2 * l - q;
            var hk = (h % 360) / 360;
            r = hue2rgb(p,q,hk + 1/3);
            g = hue2rgb(p,q,hk);
            b = hue2rgb(p,q,hk - 1/3);
        }
        var R = Math.round(r * 255), G = Math.round(g * 255), B = Math.round(b * 255);
        if (a >= 1) return '#' + [R,G,B].map(function(n){ return ('0'+(n&255).toString(16)).slice(-2); }).join('');
        return 'rgba(' + [R,G,B,a].join(',') + ')';
    }
    var named = {'red':'#ff0000','green':'#008000','blue':'#0000ff','black':'#000000','white':'#ffffff'};
    if (named[val]) return named[val];
    return val;
}

function normalizeUnit(val) {
    if (val === undefined || val === null) return val;
    var s = String(val).trim().toLowerCase();
    if (/^[0-9.]+$/.test(s)) return s + 'px';
    // strip spaces and normalize like "12 PX" -> "12px"
    s = s.replace(/\s+/g,'');
    return s;
}

// getComputedStyle that applies rules by specificity & order, with inline style winning
// Normalizes colors and common unit properties
function getComputedStyle(el) {
    if (!el || !el.getAttribute) return { getPropertyValue: function() { return ''; } };
    var matched = [];
    for (var i=0;i<__rfox_rules.length;i++) {
        var r = __rfox_rules[i];
        try {
            if (__matches(el, r.selector)) matched.push(r);
        } catch(e) { /* ignore selector errors */ }
    }
    matched.sort(function(a,b) {
        if (a.specificity !== b.specificity) return a.specificity - b.specificity;
        return a.order - b.order;
    });
    var decls = {};
    for (var j=0;j<matched.length;j++) {
        var d = matched[j].decls;
        for (var k in d) { if (Object.prototype.hasOwnProperty.call(d,k)) decls[k.toLowerCase()] = d[k]; }
    }
    // inline style overrides
    var styleAttr = el.getAttribute('style') || '';
    styleAttr.split(';').forEach(function(s) { var p = s.split(':'); if (p.length === 2) decls[p[0].trim().toLowerCase()] = p[1].trim(); });

    return {
        getPropertyValue: function(prop) {
            var key = prop.toLowerCase();
            var v = decls[key];
            if (v === undefined) return '';
            if (key.indexOf('color') !== -1 || key === 'background') return normalizeColor(v);
            var unitProps = ['font-size','margin','margin-top','margin-bottom','padding','padding-top','padding-bottom','width','height'];
            if (unitProps.indexOf(key) !== -1) return normalizeUnit(v);
            return String(v).trim();
        }
    };
} 

var __rfox_console = [];
var document = { title: (typeof __RFOX_TITLE__ !== 'undefined' ? __RFOX_TITLE__ : "Title"), body: (typeof __RFOX_BODY__ !== 'undefined' ? __RFOX_BODY__ : "Body"), styles: __rfox_styles, querySelector: querySelector, querySelectorAll: querySelectorAll };
// Provide a `window` alias for tests that reference it (falls back to globalThis)
var window = (typeof window !== 'undefined') ? window : (typeof globalThis !== 'undefined' ? globalThis : this);
var console = { log: function() { var txt = Array.prototype.slice.call(arguments).join(' '); var st=''; try{ st=(new Error()).stack || (new Error()).toString(); }catch(e){} if (typeof __rfox_console_log === 'function') { try{ __rfox_console_log(txt, st); }catch(e){} } else { __rfox_console.push(txt); } }, error: function() { var txt = Array.prototype.slice.call(arguments).join(' '); var st=''; try{ st=(new Error()).stack || (new Error()).toString(); }catch(e){} if (typeof __rfox_console_error === 'function') { try{ __rfox_console_error(txt, st); }catch(e){} } else { __rfox_console.push(txt); } } };

// Microtask & macrotask (timer) support for M1
var __rfox_microtasks = [];
function queueMicrotask(fn) {
    if (typeof fn === 'function') {
        __rfox_microtasks.push(fn);
    }
}
function __rfox_run_microtasks() {
    while (__rfox_microtasks.length) {
        var f = __rfox_microtasks.shift();
        try { f(); } catch(e) { try { console.error('microtask error', e); } catch(_) {} }
    }
}

var __rfox_now = 0; // logical time in ms for deterministic timers
var __rfox_macrotasks = []; // {id, fn, due, interval}
var __rfox_next_timer_id = 1;
function __rfox_enqueue_macrotask(fn, due, id, interval) {
    __rfox_macrotasks.push({ id: id, fn: fn, due: due === undefined ? __rfox_now : due, interval: interval || 0 });
}

function setTimeout(fn, delay) {
    var cb = (typeof fn === 'function') ? fn : function() { try { eval(fn); } catch(e) {} };
    var id = __rfox_next_timer_id++;
    __rfox_enqueue_macrotask(cb, __rfox_now + (delay||0), id, 0);
    return id;
}
function clearTimeout(id) {
    for (var i=0;i<__rfox_macrotasks.length;i++) { if (__rfox_macrotasks[i].id === id) { __rfox_macrotasks.splice(i,1); return; } }
}
function setInterval(fn, interval) {
    var cb = (typeof fn === 'function') ? fn : function() { try { eval(fn); } catch(e) {} };
    var id = __rfox_next_timer_id++;
    __rfox_enqueue_macrotask(cb, __rfox_now + (interval||0), id, interval||0);
    return id;
}
function clearInterval(id) { clearTimeout(id); }

function __rfox_run_one_macrotask() {
    // find first macrotask that is due
    var idx = -1;
    for (var i=0;i<__rfox_macrotasks.length;i++) {
        if (__rfox_macrotasks[i].due <= __rfox_now) { idx = i; break; }
    }
    if (idx === -1) return false;
    var t = __rfox_macrotasks.splice(idx,1)[0];
    try { t.fn(); } catch(e) { try { console.error('macrotask error', e); } catch(_) {} }
    // if interval, reschedule
    if (t.interval && t.interval > 0) {
        __rfox_enqueue_macrotask(t.fn, __rfox_now + t.interval, t.id, t.interval);
    }
    return true;
}

function __rfox_run_until_idle(max_iters) {
    var iters = 0;
    var executed = false;
    max_iters = max_iters || 10000; // safety bound
    while (iters++ < max_iters) {
        __rfox_run_microtasks();
        var ran = __rfox_run_one_macrotask();
        if (!ran) break;
        executed = true;
    }
    // final microtasks drain
    __rfox_run_microtasks();
    return executed;
}

function __rfox_tick(ms) {
    // advance logical time and run tasks due
    __rfox_now += (ms||0);
    __rfox_run_until_idle();
}

// Minimal Promise polyfill only if missing (simple, job-queue style via queueMicrotask)
(function(){
    if (typeof Promise !== 'function') {
        function SimplePromise(executor) {
            this._state = 'pending';
            this._value = undefined;
            this._handlers = [];
            var resolve = function(v) {
                if (this._state !== 'pending') return;
                this._state = 'fulfilled';
                this._value = v;
                // Use a plain function to be compatible with older runtimes and engines
                this._handlers.forEach(function(h) {
                    queueMicrotask(function() { if (h.onFulfilled) { try { h.onFulfilled(v); } catch(e) { if (h.onRejected) h.onRejected(e); } } });
                });
            };
            var reject = function(e) {
                if (this._state !== 'pending') return;
                this._state = 'rejected';
                this._value = e;
                this._handlers.forEach(function(h) {
                    queueMicrotask(function() { if (h.onRejected) { try { h.onRejected(e); } catch(err) {} } });
                });
            };
            try { executor(resolve, reject); } catch(e) { reject(e); }
        }
        SimplePromise.prototype.then = function(onFulfilled, onRejected) {
            var self = this;
            return new SimplePromise(function(resolve, reject){
                function handleFul(v){ try { if (onFulfilled) { resolve(onFulfilled(v)); } else { resolve(v); } } catch(e) { reject(e); } }
                function handleRej(e){ try { if (onRejected) { resolve(onRejected(e)); } else { reject(e); } } catch(err) { reject(err); } }
                if (self._state === 'pending') { self._handlers.push({ onFulfilled: handleFul, onRejected: handleRej }); }
                else if (self._state === 'fulfilled') { queueMicrotask(function(){ handleFul(self._value); }); }
                else { queueMicrotask(function(){ handleRej(self._value); }); }
            });
        };
        SimplePromise.prototype.catch = function(fn){ return this.then(null, fn); };
        SimplePromise.resolve = function(v){ return new SimplePromise(function(r){ r(v); }); };
        SimplePromise.reject = function(e){ return new SimplePromise(function(_,rej){ rej(e); }); };
        Promise = SimplePromise;
    }
})();

// Expose helper for manual flushing from host-side tests
// __rfox_run_until_idle() is already available to call from host-injected script