Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 50 additions & 1 deletion src/__tests__/utils/output.test.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -2,9 +2,22 @@ import {describe, it, expect, vi, beforeEach, afterEach} from 'vitest';
import fs from 'fs';
import path from 'path';
import os from 'os';
import {serialize, format_from_ext, print} from '../../utils/output';

const mocks = vi.hoisted(()=>({
get_config: vi.fn(),
}));
vi.mock('../../utils/config', ()=>({
get: mocks.get_config,
}));

import {serialize, format_from_ext, print} from '../../utils/output';
describe('utils/output.serialize csv', ()=>{
beforeEach(()=>{
mocks.get_config.mockReturnValue(true);
});
afterEach(()=>{
mocks.get_config.mockReset();
});
it('serializes array of flat objects as RFC 4180 CSV with header row', ()=>{
const rows = [
{url: 'https://a.test/1', title: 'A', price: 1.5},
Expand DownExpand Up@@ -46,6 +59,42 @@ describe('utils/output.serialize csv', ()=>{
const lines = out.trim().split('\n');
expect(lines[1]).toBe('1,"{""tag"":""x""}"');
});
it('sanitizes spreadsheet formula prefixes in CSV string cells', ()=>{
const rows = [{
equals: '=1+1',
space: ' =1+1',
multi_space: ' =1+1',
tab: '\t=1+1',
nbsp: '\u00a0=1+1',
plus: '+cmd',
minus: '-SUM(A1:A2)',
at: '@SUM(A1:A2)',
}];
const out = serialize(rows, 'csv');
expect(out).toContain("'=1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("'\t=1+1");
expect(out).toContain("'\u00a0=1+1");
expect(out).toContain("'+cmd");
expect(out).toContain("'-SUM(A1:A2)");
expect(out).toContain("'@SUM(A1:A2)");
});
it('does not sanitize numeric values', ()=>{
const out = serialize([{value: -100}], 'csv');
const lines = out.trim().split('\n');
expect(lines[1]).toBe('-100');
});
it('preserves numeric-looking CSV strings', ()=>{
const out = serialize([{negative: '-100', positive: '+15'}], 'csv');
expect(out).toContain('-100,+15');
});
it('does not sanitize CSV cells when sanitize_csv is false', ()=>{
mocks.get_config.mockReturnValue(false);
const out = serialize([{value: '=1+1'}], 'csv');
expect(out).toContain('=1+1');
expect(out).not.toContain("'=1+1");
});
});

describe('utils/output.serialize markdown', ()=>{
Expand Down
15 changes: 13 additions & 2 deletions src/commands/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ const CONFIG_KEYS: Config_key[] = [
'default_zone_serp',
'default_format',
'api_url',
'sanitize_csv',
];

const format_keys = ()=>CONFIG_KEYS.join(', ');
Expand DownExpand Up@@ -50,12 +51,22 @@ const handle_get_config = (key: string)=>{
);
return;
}
process.stdout.write(value+'\n');
process.stdout.write(String(value)+'\n');
};

const handle_set_config = (key: string, value: string)=>{
const valid_key = ensure_valid_key(key);
set_config(valid_key, value);
if (valid_key == 'sanitize_csv')
{
if (value != 'true' && value != 'false')
{
fail('sanitize_csv must be true or false');
return;
}
set_config(valid_key, value == 'true');
}
else
set_config(valid_key, value);
success(`Config updated: ${valid_key}=${value}`);
};

Expand Down
12 changes: 9 additions & 3 deletions src/utils/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -9,11 +9,17 @@ type Config = {
default_zone_serp?: string;
default_format?: string;
api_url?: string;
sanitize_csv?: boolean;
};

type String_config_key = {
[K in keyof Config]-?: Config[K] extends string|undefined ? K : never
}[keyof Config];

const DEFAULTS: Config = {
default_format: 'markdown',
api_url: 'https://api.brightdata.com',
sanitize_csv: true,
};

const load = (): Config=>{
Expand All@@ -35,12 +41,12 @@ const save = (config: Config)=>{
fs.writeFileSync(get_config_path(), JSON.stringify(config, null, 4));
};

const get = (key: keyof Config): string|undefined=>{
const get = <K extends keyof Config>(key: K): Config[K]=>{
const config = load();
return config[key];
};

const set = (key: keyof Config, value: string)=>{
const set = <K extends keyof Config>(key: K, value: Config[K])=>{
const config = load();
config[key] = value;
save(config);
Expand All@@ -50,7 +56,7 @@ const set = (key: keyof Config, value: string)=>{
const resolve = (
cli_val: string|undefined,
env_key: string,
config_key: keyof Config
config_key: String_config_key
): string|undefined=>{
if (cli_val)
return cli_val;
Expand Down
17 changes: 15 additions & 2 deletions src/utils/output.ts
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
import fs from 'fs';
import path from 'path';

import {get as get_config} from './config';

const is_tty = process.stdout.isTTY === true;

const ansi = (code: string, text: string)=>
Expand DownExpand Up@@ -84,10 +86,21 @@ const cell_to_string = (val: unknown): string=>{
return JSON.stringify(val);
};

const sanitize_csv_cell = (s: string): string=>{

@artemo-brdartemo-brdAug 31, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add a global sanitize_csv configuration option that users can set with:

brightdata config set sanitize_csv false
brightdata config set sanitize_csv true

It should default to true. Since config values currently enter through the CLI as strings, please validate and convert "true"/"false" to actual booleans when setting or reading this option; "false" must not be treated as a truthy string. Other values should be rejected.

We can add per-command overrides later if needed (scrape, search, pipelines, discover, scraper, browser),

const trimmed = s.trim();
if (/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/.test(trimmed))
return s;
if (/^[\s\u00a0]*[=+\-@]/.test(s))
return "'" + s;
return s;
};

const csv_escape = (val: unknown): string=>{
const s = cell_to_string(val);
let s = cell_to_string(val);
if (typeof val == 'string' && get_config('sanitize_csv') !== false)
s = sanitize_csv_cell(s);
if (/[",\r\n]/.test(s))
return '"'+s.replace(/"/g, '""')+'"';
return '"' + s.replace(/"/g, '""') + '"';
return s;
};

Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 50 additions & 1 deletion src/__tests__/utils/output.test.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -2,9 +2,22 @@ import {describe, it, expect, vi, beforeEach, afterEach} from 'vitest';
import fs from 'fs';
import path from 'path';
import os from 'os';
import {serialize, format_from_ext, print} from '../../utils/output';

const mocks = vi.hoisted(()=>({
get_config: vi.fn(),
}));
vi.mock('../../utils/config', ()=>({
get: mocks.get_config,
}));

import {serialize, format_from_ext, print} from '../../utils/output';
describe('utils/output.serialize csv', ()=>{
beforeEach(()=>{
mocks.get_config.mockReturnValue(true);
});
afterEach(()=>{
mocks.get_config.mockReset();
});
it('serializes array of flat objects as RFC 4180 CSV with header row', ()=>{
const rows = [
{url: 'https://a.test/1', title: 'A', price: 1.5},
Expand DownExpand Up@@ -46,6 +59,42 @@ describe('utils/output.serialize csv', ()=>{
const lines = out.trim().split('\n');
expect(lines[1]).toBe('1,"{""tag"":""x""}"');
});
it('sanitizes spreadsheet formula prefixes in CSV string cells', ()=>{
const rows = [{
equals: '=1+1',
space: ' =1+1',
multi_space: ' =1+1',
tab: '\t=1+1',
nbsp: '\u00a0=1+1',
plus: '+cmd',
minus: '-SUM(A1:A2)',
at: '@SUM(A1:A2)',
}];
const out = serialize(rows, 'csv');
expect(out).toContain("'=1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("'\t=1+1");
expect(out).toContain("'\u00a0=1+1");
expect(out).toContain("'+cmd");
expect(out).toContain("'-SUM(A1:A2)");
expect(out).toContain("'@SUM(A1:A2)");
});
it('does not sanitize numeric values', ()=>{
const out = serialize([{value: -100}], 'csv');
const lines = out.trim().split('\n');
expect(lines[1]).toBe('-100');
});
it('preserves numeric-looking CSV strings', ()=>{
const out = serialize([{negative: '-100', positive: '+15'}], 'csv');
expect(out).toContain('-100,+15');
});
it('does not sanitize CSV cells when sanitize_csv is false', ()=>{
mocks.get_config.mockReturnValue(false);
const out = serialize([{value: '=1+1'}], 'csv');
expect(out).toContain('=1+1');
expect(out).not.toContain("'=1+1");
});
});

describe('utils/output.serialize markdown', ()=>{
Expand Down
15 changes: 13 additions & 2 deletions src/commands/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ const CONFIG_KEYS: Config_key[] = [
'default_zone_serp',
'default_format',
'api_url',
'sanitize_csv',
];

const format_keys = ()=>CONFIG_KEYS.join(', ');
Expand DownExpand Up@@ -50,12 +51,22 @@ const handle_get_config = (key: string)=>{
);
return;
}
process.stdout.write(value+'\n');
process.stdout.write(String(value)+'\n');
};

const handle_set_config = (key: string, value: string)=>{
const valid_key = ensure_valid_key(key);
set_config(valid_key, value);
if (valid_key == 'sanitize_csv')
{
if (value != 'true' && value != 'false')
{
fail('sanitize_csv must be true or false');
return;
}
set_config(valid_key, value == 'true');
}
else
set_config(valid_key, value);
success(`Config updated: ${valid_key}=${value}`);
};

Expand Down
12 changes: 9 additions & 3 deletions src/utils/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -9,11 +9,17 @@ type Config = {
default_zone_serp?: string;
default_format?: string;
api_url?: string;
sanitize_csv?: boolean;
};

type String_config_key = {
[K in keyof Config]-?: Config[K] extends string|undefined ? K : never
}[keyof Config];

const DEFAULTS: Config = {
default_format: 'markdown',
api_url: 'https://api.brightdata.com',
sanitize_csv: true,
};

const load = (): Config=>{
Expand All@@ -35,12 +41,12 @@ const save = (config: Config)=>{
fs.writeFileSync(get_config_path(), JSON.stringify(config, null, 4));
};

const get = (key: keyof Config): string|undefined=>{
const get = <K extends keyof Config>(key: K): Config[K]=>{
const config = load();
return config[key];
};

const set = (key: keyof Config, value: string)=>{
const set = <K extends keyof Config>(key: K, value: Config[K])=>{
const config = load();
config[key] = value;
save(config);
Expand All@@ -50,7 +56,7 @@ const set = (key: keyof Config, value: string)=>{
const resolve = (
cli_val: string|undefined,
env_key: string,
config_key: keyof Config
config_key: String_config_key
): string|undefined=>{
if (cli_val)
return cli_val;
Expand Down
17 changes: 15 additions & 2 deletions src/utils/output.ts
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
import fs from 'fs';
import path from 'path';

import {get as get_config} from './config';

const is_tty = process.stdout.isTTY === true;

const ansi = (code: string, text: string)=>
Expand DownExpand Up@@ -84,10 +86,21 @@ const cell_to_string = (val: unknown): string=>{
return JSON.stringify(val);
};

const sanitize_csv_cell = (s: string): string=>{

@artemo-brdartemo-brdAug 31, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add a global sanitize_csv configuration option that users can set with:

brightdata config set sanitize_csv false
brightdata config set sanitize_csv true

It should default to true. Since config values currently enter through the CLI as strings, please validate and convert "true"/"false" to actual booleans when setting or reading this option; "false" must not be treated as a truthy string. Other values should be rejected.

We can add per-command overrides later if needed (scrape, search, pipelines, discover, scraper, browser),

const trimmed = s.trim();
if (/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/.test(trimmed))
return s;
if (/^[\s\u00a0]*[=+\-@]/.test(s))
return "'" + s;
return s;
};

const csv_escape = (val: unknown): string=>{
const s = cell_to_string(val);
let s = cell_to_string(val);
if (typeof val == 'string' && get_config('sanitize_csv') !== false)
s = sanitize_csv_cell(s);
if (/[",\r\n]/.test(s))
return '"'+s.replace(/"/g, '""')+'"';
return '"' + s.replace(/"/g, '""') + '"';
return s;
};

Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 50 additions & 1 deletion src/__tests__/utils/output.test.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -2,9 +2,22 @@ import {describe, it, expect, vi, beforeEach, afterEach} from 'vitest';
import fs from 'fs';
import path from 'path';
import os from 'os';
import {serialize, format_from_ext, print} from '../../utils/output';

const mocks = vi.hoisted(()=>({
get_config: vi.fn(),
}));
vi.mock('../../utils/config', ()=>({
get: mocks.get_config,
}));

import {serialize, format_from_ext, print} from '../../utils/output';
describe('utils/output.serialize csv', ()=>{
beforeEach(()=>{
mocks.get_config.mockReturnValue(true);
});
afterEach(()=>{
mocks.get_config.mockReset();
});
it('serializes array of flat objects as RFC 4180 CSV with header row', ()=>{
const rows = [
{url: 'https://a.test/1', title: 'A', price: 1.5},
Expand DownExpand Up@@ -46,6 +59,42 @@ describe('utils/output.serialize csv', ()=>{
const lines = out.trim().split('\n');
expect(lines[1]).toBe('1,"{""tag"":""x""}"');
});
it('sanitizes spreadsheet formula prefixes in CSV string cells', ()=>{
const rows = [{
equals: '=1+1',
space: ' =1+1',
multi_space: ' =1+1',
tab: '\t=1+1',
nbsp: '\u00a0=1+1',
plus: '+cmd',
minus: '-SUM(A1:A2)',
at: '@SUM(A1:A2)',
}];
const out = serialize(rows, 'csv');
expect(out).toContain("'=1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("'\t=1+1");
expect(out).toContain("'\u00a0=1+1");
expect(out).toContain("'+cmd");
expect(out).toContain("'-SUM(A1:A2)");
expect(out).toContain("'@SUM(A1:A2)");
});
it('does not sanitize numeric values', ()=>{
const out = serialize([{value: -100}], 'csv');
const lines = out.trim().split('\n');
expect(lines[1]).toBe('-100');
});
it('preserves numeric-looking CSV strings', ()=>{
const out = serialize([{negative: '-100', positive: '+15'}], 'csv');
expect(out).toContain('-100,+15');
});
it('does not sanitize CSV cells when sanitize_csv is false', ()=>{
mocks.get_config.mockReturnValue(false);
const out = serialize([{value: '=1+1'}], 'csv');
expect(out).toContain('=1+1');
expect(out).not.toContain("'=1+1");
});
});

describe('utils/output.serialize markdown', ()=>{
Expand Down
15 changes: 13 additions & 2 deletions src/commands/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ const CONFIG_KEYS: Config_key[] = [
'default_zone_serp',
'default_format',
'api_url',
'sanitize_csv',
];

const format_keys = ()=>CONFIG_KEYS.join(', ');
Expand DownExpand Up@@ -50,12 +51,22 @@ const handle_get_config = (key: string)=>{
);
return;
}
process.stdout.write(value+'\n');
process.stdout.write(String(value)+'\n');
};

const handle_set_config = (key: string, value: string)=>{
const valid_key = ensure_valid_key(key);
set_config(valid_key, value);
if (valid_key == 'sanitize_csv')
{
if (value != 'true' && value != 'false')
{
fail('sanitize_csv must be true or false');
return;
}
set_config(valid_key, value == 'true');
}
else
set_config(valid_key, value);
success(`Config updated: ${valid_key}=${value}`);
};

Expand Down
12 changes: 9 additions & 3 deletions src/utils/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -9,11 +9,17 @@ type Config = {
default_zone_serp?: string;
default_format?: string;
api_url?: string;
sanitize_csv?: boolean;
};

type String_config_key = {
[K in keyof Config]-?: Config[K] extends string|undefined ? K : never
}[keyof Config];

const DEFAULTS: Config = {
default_format: 'markdown',
api_url: 'https://api.brightdata.com',
sanitize_csv: true,
};

const load = (): Config=>{
Expand All@@ -35,12 +41,12 @@ const save = (config: Config)=>{
fs.writeFileSync(get_config_path(), JSON.stringify(config, null, 4));
};

const get = (key: keyof Config): string|undefined=>{
const get = <K extends keyof Config>(key: K): Config[K]=>{
const config = load();
return config[key];
};

const set = (key: keyof Config, value: string)=>{
const set = <K extends keyof Config>(key: K, value: Config[K])=>{
const config = load();
config[key] = value;
save(config);
Expand All@@ -50,7 +56,7 @@ const set = (key: keyof Config, value: string)=>{
const resolve = (
cli_val: string|undefined,
env_key: string,
config_key: keyof Config
config_key: String_config_key
): string|undefined=>{
if (cli_val)
return cli_val;
Expand Down
17 changes: 15 additions & 2 deletions src/utils/output.ts
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
import fs from 'fs';
import path from 'path';

import {get as get_config} from './config';

const is_tty = process.stdout.isTTY === true;

const ansi = (code: string, text: string)=>
Expand DownExpand Up@@ -84,10 +86,21 @@ const cell_to_string = (val: unknown): string=>{
return JSON.stringify(val);
};

const sanitize_csv_cell = (s: string): string=>{

@artemo-brdartemo-brdAug 31, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add a global sanitize_csv configuration option that users can set with:

brightdata config set sanitize_csv false
brightdata config set sanitize_csv true

It should default to true. Since config values currently enter through the CLI as strings, please validate and convert "true"/"false" to actual booleans when setting or reading this option; "false" must not be treated as a truthy string. Other values should be rejected.

We can add per-command overrides later if needed (scrape, search, pipelines, discover, scraper, browser),

const trimmed = s.trim();
if (/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/.test(trimmed))
return s;
if (/^[\s\u00a0]*[=+\-@]/.test(s))
return "'" + s;
return s;
};

const csv_escape = (val: unknown): string=>{
const s = cell_to_string(val);
let s = cell_to_string(val);
if (typeof val == 'string' && get_config('sanitize_csv') !== false)
s = sanitize_csv_cell(s);
if (/[",\r\n]/.test(s))
return '"'+s.replace(/"/g, '""')+'"';
return '"' + s.replace(/"/g, '""') + '"';
return s;
};

Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 50 additions & 1 deletion src/__tests__/utils/output.test.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -2,9 +2,22 @@ import {describe, it, expect, vi, beforeEach, afterEach} from 'vitest';
import fs from 'fs';
import path from 'path';
import os from 'os';
import {serialize, format_from_ext, print} from '../../utils/output';

const mocks = vi.hoisted(()=>({
get_config: vi.fn(),
}));
vi.mock('../../utils/config', ()=>({
get: mocks.get_config,
}));

import {serialize, format_from_ext, print} from '../../utils/output';
describe('utils/output.serialize csv', ()=>{
beforeEach(()=>{
mocks.get_config.mockReturnValue(true);
});
afterEach(()=>{
mocks.get_config.mockReset();
});
it('serializes array of flat objects as RFC 4180 CSV with header row', ()=>{
const rows = [
{url: 'https://a.test/1', title: 'A', price: 1.5},
Expand DownExpand Up@@ -46,6 +59,42 @@ describe('utils/output.serialize csv', ()=>{
const lines = out.trim().split('\n');
expect(lines[1]).toBe('1,"{""tag"":""x""}"');
});
it('sanitizes spreadsheet formula prefixes in CSV string cells', ()=>{
const rows = [{
equals: '=1+1',
space: ' =1+1',
multi_space: ' =1+1',
tab: '\t=1+1',
nbsp: '\u00a0=1+1',
plus: '+cmd',
minus: '-SUM(A1:A2)',
at: '@SUM(A1:A2)',
}];
const out = serialize(rows, 'csv');
expect(out).toContain("'=1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("'\t=1+1");
expect(out).toContain("'\u00a0=1+1");
expect(out).toContain("'+cmd");
expect(out).toContain("'-SUM(A1:A2)");
expect(out).toContain("'@SUM(A1:A2)");
});
it('does not sanitize numeric values', ()=>{
const out = serialize([{value: -100}], 'csv');
const lines = out.trim().split('\n');
expect(lines[1]).toBe('-100');
});
it('preserves numeric-looking CSV strings', ()=>{
const out = serialize([{negative: '-100', positive: '+15'}], 'csv');
expect(out).toContain('-100,+15');
});
it('does not sanitize CSV cells when sanitize_csv is false', ()=>{
mocks.get_config.mockReturnValue(false);
const out = serialize([{value: '=1+1'}], 'csv');
expect(out).toContain('=1+1');
expect(out).not.toContain("'=1+1");
});
});

describe('utils/output.serialize markdown', ()=>{
Expand Down
15 changes: 13 additions & 2 deletions src/commands/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ const CONFIG_KEYS: Config_key[] = [
'default_zone_serp',
'default_format',
'api_url',
'sanitize_csv',
];

const format_keys = ()=>CONFIG_KEYS.join(', ');
Expand DownExpand Up@@ -50,12 +51,22 @@ const handle_get_config = (key: string)=>{
);
return;
}
process.stdout.write(value+'\n');
process.stdout.write(String(value)+'\n');
};

const handle_set_config = (key: string, value: string)=>{
const valid_key = ensure_valid_key(key);
set_config(valid_key, value);
if (valid_key == 'sanitize_csv')
{
if (value != 'true' && value != 'false')
{
fail('sanitize_csv must be true or false');
return;
}
set_config(valid_key, value == 'true');
}
else
set_config(valid_key, value);
success(`Config updated: ${valid_key}=${value}`);
};

Expand Down
12 changes: 9 additions & 3 deletions src/utils/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -9,11 +9,17 @@ type Config = {
default_zone_serp?: string;
default_format?: string;
api_url?: string;
sanitize_csv?: boolean;
};

type String_config_key = {
[K in keyof Config]-?: Config[K] extends string|undefined ? K : never
}[keyof Config];

const DEFAULTS: Config = {
default_format: 'markdown',
api_url: 'https://api.brightdata.com',
sanitize_csv: true,
};

const load = (): Config=>{
Expand All@@ -35,12 +41,12 @@ const save = (config: Config)=>{
fs.writeFileSync(get_config_path(), JSON.stringify(config, null, 4));
};

const get = (key: keyof Config): string|undefined=>{
const get = <K extends keyof Config>(key: K): Config[K]=>{
const config = load();
return config[key];
};

const set = (key: keyof Config, value: string)=>{
const set = <K extends keyof Config>(key: K, value: Config[K])=>{
const config = load();
config[key] = value;
save(config);
Expand All@@ -50,7 +56,7 @@ const set = (key: keyof Config, value: string)=>{
const resolve = (
cli_val: string|undefined,
env_key: string,
config_key: keyof Config
config_key: String_config_key
): string|undefined=>{
if (cli_val)
return cli_val;
Expand Down
17 changes: 15 additions & 2 deletions src/utils/output.ts
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
import fs from 'fs';
import path from 'path';

import {get as get_config} from './config';

const is_tty = process.stdout.isTTY === true;

const ansi = (code: string, text: string)=>
Expand DownExpand Up@@ -84,10 +86,21 @@ const cell_to_string = (val: unknown): string=>{
return JSON.stringify(val);
};

const sanitize_csv_cell = (s: string): string=>{

@artemo-brdartemo-brdAug 31, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add a global sanitize_csv configuration option that users can set with:

brightdata config set sanitize_csv false
brightdata config set sanitize_csv true

It should default to true. Since config values currently enter through the CLI as strings, please validate and convert "true"/"false" to actual booleans when setting or reading this option; "false" must not be treated as a truthy string. Other values should be rejected.

We can add per-command overrides later if needed (scrape, search, pipelines, discover, scraper, browser),

const trimmed = s.trim();
if (/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/.test(trimmed))
return s;
if (/^[\s\u00a0]*[=+\-@]/.test(s))
return "'" + s;
return s;
};

const csv_escape = (val: unknown): string=>{
const s = cell_to_string(val);
let s = cell_to_string(val);
if (typeof val == 'string' && get_config('sanitize_csv') !== false)
s = sanitize_csv_cell(s);
if (/[",\r\n]/.test(s))
return '"'+s.replace(/"/g, '""')+'"';
return '"' + s.replace(/"/g, '""') + '"';
return s;
};

Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 50 additions & 1 deletion src/__tests__/utils/output.test.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -2,9 +2,22 @@ import {describe, it, expect, vi, beforeEach, afterEach} from 'vitest';
import fs from 'fs';
import path from 'path';
import os from 'os';
import {serialize, format_from_ext, print} from '../../utils/output';

const mocks = vi.hoisted(()=>({
get_config: vi.fn(),
}));
vi.mock('../../utils/config', ()=>({
get: mocks.get_config,
}));

import {serialize, format_from_ext, print} from '../../utils/output';
describe('utils/output.serialize csv', ()=>{
beforeEach(()=>{
mocks.get_config.mockReturnValue(true);
});
afterEach(()=>{
mocks.get_config.mockReset();
});
it('serializes array of flat objects as RFC 4180 CSV with header row', ()=>{
const rows = [
{url: 'https://a.test/1', title: 'A', price: 1.5},
Expand DownExpand Up@@ -46,6 +59,42 @@ describe('utils/output.serialize csv', ()=>{
const lines = out.trim().split('\n');
expect(lines[1]).toBe('1,"{""tag"":""x""}"');
});
it('sanitizes spreadsheet formula prefixes in CSV string cells', ()=>{
const rows = [{
equals: '=1+1',
space: ' =1+1',
multi_space: ' =1+1',
tab: '\t=1+1',
nbsp: '\u00a0=1+1',
plus: '+cmd',
minus: '-SUM(A1:A2)',
at: '@SUM(A1:A2)',
}];
const out = serialize(rows, 'csv');
expect(out).toContain("'=1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("'\t=1+1");
expect(out).toContain("'\u00a0=1+1");
expect(out).toContain("'+cmd");
expect(out).toContain("'-SUM(A1:A2)");
expect(out).toContain("'@SUM(A1:A2)");
});
it('does not sanitize numeric values', ()=>{
const out = serialize([{value: -100}], 'csv');
const lines = out.trim().split('\n');
expect(lines[1]).toBe('-100');
});
it('preserves numeric-looking CSV strings', ()=>{
const out = serialize([{negative: '-100', positive: '+15'}], 'csv');
expect(out).toContain('-100,+15');
});
it('does not sanitize CSV cells when sanitize_csv is false', ()=>{
mocks.get_config.mockReturnValue(false);
const out = serialize([{value: '=1+1'}], 'csv');
expect(out).toContain('=1+1');
expect(out).not.toContain("'=1+1");
});
});

describe('utils/output.serialize markdown', ()=>{
Expand Down
15 changes: 13 additions & 2 deletions src/commands/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ const CONFIG_KEYS: Config_key[] = [
'default_zone_serp',
'default_format',
'api_url',
'sanitize_csv',
];

const format_keys = ()=>CONFIG_KEYS.join(', ');
Expand DownExpand Up@@ -50,12 +51,22 @@ const handle_get_config = (key: string)=>{
);
return;
}
process.stdout.write(value+'\n');
process.stdout.write(String(value)+'\n');
};

const handle_set_config = (key: string, value: string)=>{
const valid_key = ensure_valid_key(key);
set_config(valid_key, value);
if (valid_key == 'sanitize_csv')
{
if (value != 'true' && value != 'false')
{
fail('sanitize_csv must be true or false');
return;
}
set_config(valid_key, value == 'true');
}
else
set_config(valid_key, value);
success(`Config updated: ${valid_key}=${value}`);
};

Expand Down
12 changes: 9 additions & 3 deletions src/utils/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -9,11 +9,17 @@ type Config = {
default_zone_serp?: string;
default_format?: string;
api_url?: string;
sanitize_csv?: boolean;
};

type String_config_key = {
[K in keyof Config]-?: Config[K] extends string|undefined ? K : never
}[keyof Config];

const DEFAULTS: Config = {
default_format: 'markdown',
api_url: 'https://api.brightdata.com',
sanitize_csv: true,
};

const load = (): Config=>{
Expand All@@ -35,12 +41,12 @@ const save = (config: Config)=>{
fs.writeFileSync(get_config_path(), JSON.stringify(config, null, 4));
};

const get = (key: keyof Config): string|undefined=>{
const get = <K extends keyof Config>(key: K): Config[K]=>{
const config = load();
return config[key];
};

const set = (key: keyof Config, value: string)=>{
const set = <K extends keyof Config>(key: K, value: Config[K])=>{
const config = load();
config[key] = value;
save(config);
Expand All@@ -50,7 +56,7 @@ const set = (key: keyof Config, value: string)=>{
const resolve = (
cli_val: string|undefined,
env_key: string,
config_key: keyof Config
config_key: String_config_key
): string|undefined=>{
if (cli_val)
return cli_val;
Expand Down
17 changes: 15 additions & 2 deletions src/utils/output.ts
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
import fs from 'fs';
import path from 'path';

import {get as get_config} from './config';

const is_tty = process.stdout.isTTY === true;

const ansi = (code: string, text: string)=>
Expand DownExpand Up@@ -84,10 +86,21 @@ const cell_to_string = (val: unknown): string=>{
return JSON.stringify(val);
};

const sanitize_csv_cell = (s: string): string=>{

@artemo-brdartemo-brdAug 31, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add a global sanitize_csv configuration option that users can set with:

brightdata config set sanitize_csv false
brightdata config set sanitize_csv true

It should default to true. Since config values currently enter through the CLI as strings, please validate and convert "true"/"false" to actual booleans when setting or reading this option; "false" must not be treated as a truthy string. Other values should be rejected.

We can add per-command overrides later if needed (scrape, search, pipelines, discover, scraper, browser),

const trimmed = s.trim();
if (/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/.test(trimmed))
return s;
if (/^[\s\u00a0]*[=+\-@]/.test(s))
return "'" + s;
return s;
};

const csv_escape = (val: unknown): string=>{
const s = cell_to_string(val);
let s = cell_to_string(val);
if (typeof val == 'string' && get_config('sanitize_csv') !== false)
s = sanitize_csv_cell(s);
if (/[",\r\n]/.test(s))
return '"'+s.replace(/"/g, '""')+'"';
return '"' + s.replace(/"/g, '""') + '"';
return s;
};

Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 50 additions & 1 deletion src/__tests__/utils/output.test.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -2,9 +2,22 @@ import {describe, it, expect, vi, beforeEach, afterEach} from 'vitest';
import fs from 'fs';
import path from 'path';
import os from 'os';
import {serialize, format_from_ext, print} from '../../utils/output';

const mocks = vi.hoisted(()=>({
get_config: vi.fn(),
}));
vi.mock('../../utils/config', ()=>({
get: mocks.get_config,
}));

import {serialize, format_from_ext, print} from '../../utils/output';
describe('utils/output.serialize csv', ()=>{
beforeEach(()=>{
mocks.get_config.mockReturnValue(true);
});
afterEach(()=>{
mocks.get_config.mockReset();
});
it('serializes array of flat objects as RFC 4180 CSV with header row', ()=>{
const rows = [
{url: 'https://a.test/1', title: 'A', price: 1.5},
Expand DownExpand Up@@ -46,6 +59,42 @@ describe('utils/output.serialize csv', ()=>{
const lines = out.trim().split('\n');
expect(lines[1]).toBe('1,"{""tag"":""x""}"');
});
it('sanitizes spreadsheet formula prefixes in CSV string cells', ()=>{
const rows = [{
equals: '=1+1',
space: ' =1+1',
multi_space: ' =1+1',
tab: '\t=1+1',
nbsp: '\u00a0=1+1',
plus: '+cmd',
minus: '-SUM(A1:A2)',
at: '@SUM(A1:A2)',
}];
const out = serialize(rows, 'csv');
expect(out).toContain("'=1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("'\t=1+1");
expect(out).toContain("'\u00a0=1+1");
expect(out).toContain("'+cmd");
expect(out).toContain("'-SUM(A1:A2)");
expect(out).toContain("'@SUM(A1:A2)");
});
it('does not sanitize numeric values', ()=>{
const out = serialize([{value: -100}], 'csv');
const lines = out.trim().split('\n');
expect(lines[1]).toBe('-100');
});
it('preserves numeric-looking CSV strings', ()=>{
const out = serialize([{negative: '-100', positive: '+15'}], 'csv');
expect(out).toContain('-100,+15');
});
it('does not sanitize CSV cells when sanitize_csv is false', ()=>{
mocks.get_config.mockReturnValue(false);
const out = serialize([{value: '=1+1'}], 'csv');
expect(out).toContain('=1+1');
expect(out).not.toContain("'=1+1");
});
});

describe('utils/output.serialize markdown', ()=>{
Expand Down
15 changes: 13 additions & 2 deletions src/commands/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ const CONFIG_KEYS: Config_key[] = [
'default_zone_serp',
'default_format',
'api_url',
'sanitize_csv',
];

const format_keys = ()=>CONFIG_KEYS.join(', ');
Expand DownExpand Up@@ -50,12 +51,22 @@ const handle_get_config = (key: string)=>{
);
return;
}
process.stdout.write(value+'\n');
process.stdout.write(String(value)+'\n');
};

const handle_set_config = (key: string, value: string)=>{
const valid_key = ensure_valid_key(key);
set_config(valid_key, value);
if (valid_key == 'sanitize_csv')
{
if (value != 'true' && value != 'false')
{
fail('sanitize_csv must be true or false');
return;
}
set_config(valid_key, value == 'true');
}
else
set_config(valid_key, value);
success(`Config updated: ${valid_key}=${value}`);
};

Expand Down
12 changes: 9 additions & 3 deletions src/utils/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -9,11 +9,17 @@ type Config = {
default_zone_serp?: string;
default_format?: string;
api_url?: string;
sanitize_csv?: boolean;
};

type String_config_key = {
[K in keyof Config]-?: Config[K] extends string|undefined ? K : never
}[keyof Config];

const DEFAULTS: Config = {
default_format: 'markdown',
api_url: 'https://api.brightdata.com',
sanitize_csv: true,
};

const load = (): Config=>{
Expand All@@ -35,12 +41,12 @@ const save = (config: Config)=>{
fs.writeFileSync(get_config_path(), JSON.stringify(config, null, 4));
};

const get = (key: keyof Config): string|undefined=>{
const get = <K extends keyof Config>(key: K): Config[K]=>{
const config = load();
return config[key];
};

const set = (key: keyof Config, value: string)=>{
const set = <K extends keyof Config>(key: K, value: Config[K])=>{
const config = load();
config[key] = value;
save(config);
Expand All@@ -50,7 +56,7 @@ const set = (key: keyof Config, value: string)=>{
const resolve = (
cli_val: string|undefined,
env_key: string,
config_key: keyof Config
config_key: String_config_key
): string|undefined=>{
if (cli_val)
return cli_val;
Expand Down
17 changes: 15 additions & 2 deletions src/utils/output.ts
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
import fs from 'fs';
import path from 'path';

import {get as get_config} from './config';

const is_tty = process.stdout.isTTY === true;

const ansi = (code: string, text: string)=>
Expand DownExpand Up@@ -84,10 +86,21 @@ const cell_to_string = (val: unknown): string=>{
return JSON.stringify(val);
};

const sanitize_csv_cell = (s: string): string=>{

@artemo-brdartemo-brdAug 31, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add a global sanitize_csv configuration option that users can set with:

brightdata config set sanitize_csv false
brightdata config set sanitize_csv true

It should default to true. Since config values currently enter through the CLI as strings, please validate and convert "true"/"false" to actual booleans when setting or reading this option; "false" must not be treated as a truthy string. Other values should be rejected.

We can add per-command overrides later if needed (scrape, search, pipelines, discover, scraper, browser),

const trimmed = s.trim();
if (/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/.test(trimmed))
return s;
if (/^[\s\u00a0]*[=+\-@]/.test(s))
return "'" + s;
return s;
};

const csv_escape = (val: unknown): string=>{
const s = cell_to_string(val);
let s = cell_to_string(val);
if (typeof val == 'string' && get_config('sanitize_csv') !== false)
s = sanitize_csv_cell(s);
if (/[",\r\n]/.test(s))
return '"'+s.replace(/"/g, '""')+'"';
return '"' + s.replace(/"/g, '""') + '"';
return s;
};

Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 50 additions & 1 deletion src/__tests__/utils/output.test.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -2,9 +2,22 @@ import {describe, it, expect, vi, beforeEach, afterEach} from 'vitest';
import fs from 'fs';
import path from 'path';
import os from 'os';
import {serialize, format_from_ext, print} from '../../utils/output';

const mocks = vi.hoisted(()=>({
get_config: vi.fn(),
}));
vi.mock('../../utils/config', ()=>({
get: mocks.get_config,
}));

import {serialize, format_from_ext, print} from '../../utils/output';
describe('utils/output.serialize csv', ()=>{
beforeEach(()=>{
mocks.get_config.mockReturnValue(true);
});
afterEach(()=>{
mocks.get_config.mockReset();
});
it('serializes array of flat objects as RFC 4180 CSV with header row', ()=>{
const rows = [
{url: 'https://a.test/1', title: 'A', price: 1.5},
Expand DownExpand Up@@ -46,6 +59,42 @@ describe('utils/output.serialize csv', ()=>{
const lines = out.trim().split('\n');
expect(lines[1]).toBe('1,"{""tag"":""x""}"');
});
it('sanitizes spreadsheet formula prefixes in CSV string cells', ()=>{
const rows = [{
equals: '=1+1',
space: ' =1+1',
multi_space: ' =1+1',
tab: '\t=1+1',
nbsp: '\u00a0=1+1',
plus: '+cmd',
minus: '-SUM(A1:A2)',
at: '@SUM(A1:A2)',
}];
const out = serialize(rows, 'csv');
expect(out).toContain("'=1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("'\t=1+1");
expect(out).toContain("'\u00a0=1+1");
expect(out).toContain("'+cmd");
expect(out).toContain("'-SUM(A1:A2)");
expect(out).toContain("'@SUM(A1:A2)");
});
it('does not sanitize numeric values', ()=>{
const out = serialize([{value: -100}], 'csv');
const lines = out.trim().split('\n');
expect(lines[1]).toBe('-100');
});
it('preserves numeric-looking CSV strings', ()=>{
const out = serialize([{negative: '-100', positive: '+15'}], 'csv');
expect(out).toContain('-100,+15');
});
it('does not sanitize CSV cells when sanitize_csv is false', ()=>{
mocks.get_config.mockReturnValue(false);
const out = serialize([{value: '=1+1'}], 'csv');
expect(out).toContain('=1+1');
expect(out).not.toContain("'=1+1");
});
});

describe('utils/output.serialize markdown', ()=>{
Expand Down
15 changes: 13 additions & 2 deletions src/commands/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ const CONFIG_KEYS: Config_key[] = [
'default_zone_serp',
'default_format',
'api_url',
'sanitize_csv',
];

const format_keys = ()=>CONFIG_KEYS.join(', ');
Expand DownExpand Up@@ -50,12 +51,22 @@ const handle_get_config = (key: string)=>{
);
return;
}
process.stdout.write(value+'\n');
process.stdout.write(String(value)+'\n');
};

const handle_set_config = (key: string, value: string)=>{
const valid_key = ensure_valid_key(key);
set_config(valid_key, value);
if (valid_key == 'sanitize_csv')
{
if (value != 'true' && value != 'false')
{
fail('sanitize_csv must be true or false');
return;
}
set_config(valid_key, value == 'true');
}
else
set_config(valid_key, value);
success(`Config updated: ${valid_key}=${value}`);
};

Expand Down
12 changes: 9 additions & 3 deletions src/utils/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -9,11 +9,17 @@ type Config = {
default_zone_serp?: string;
default_format?: string;
api_url?: string;
sanitize_csv?: boolean;
};

type String_config_key = {
[K in keyof Config]-?: Config[K] extends string|undefined ? K : never
}[keyof Config];

const DEFAULTS: Config = {
default_format: 'markdown',
api_url: 'https://api.brightdata.com',
sanitize_csv: true,
};

const load = (): Config=>{
Expand All@@ -35,12 +41,12 @@ const save = (config: Config)=>{
fs.writeFileSync(get_config_path(), JSON.stringify(config, null, 4));
};

const get = (key: keyof Config): string|undefined=>{
const get = <K extends keyof Config>(key: K): Config[K]=>{
const config = load();
return config[key];
};

const set = (key: keyof Config, value: string)=>{
const set = <K extends keyof Config>(key: K, value: Config[K])=>{
const config = load();
config[key] = value;
save(config);
Expand All@@ -50,7 +56,7 @@ const set = (key: keyof Config, value: string)=>{
const resolve = (
cli_val: string|undefined,
env_key: string,
config_key: keyof Config
config_key: String_config_key
): string|undefined=>{
if (cli_val)
return cli_val;
Expand Down
17 changes: 15 additions & 2 deletions src/utils/output.ts
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
import fs from 'fs';
import path from 'path';

import {get as get_config} from './config';

const is_tty = process.stdout.isTTY === true;

const ansi = (code: string, text: string)=>
Expand DownExpand Up@@ -84,10 +86,21 @@ const cell_to_string = (val: unknown): string=>{
return JSON.stringify(val);
};

const sanitize_csv_cell = (s: string): string=>{

@artemo-brdartemo-brdAug 31, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add a global sanitize_csv configuration option that users can set with:

brightdata config set sanitize_csv false
brightdata config set sanitize_csv true

It should default to true. Since config values currently enter through the CLI as strings, please validate and convert "true"/"false" to actual booleans when setting or reading this option; "false" must not be treated as a truthy string. Other values should be rejected.

We can add per-command overrides later if needed (scrape, search, pipelines, discover, scraper, browser),

const trimmed = s.trim();
if (/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/.test(trimmed))
return s;
if (/^[\s\u00a0]*[=+\-@]/.test(s))
return "'" + s;
return s;
};

const csv_escape = (val: unknown): string=>{
const s = cell_to_string(val);
let s = cell_to_string(val);
if (typeof val == 'string' && get_config('sanitize_csv') !== false)
s = sanitize_csv_cell(s);
if (/[",\r\n]/.test(s))
return '"'+s.replace(/"/g, '""')+'"';
return '"' + s.replace(/"/g, '""') + '"';
return s;
};

Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 50 additions & 1 deletion src/__tests__/utils/output.test.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -2,9 +2,22 @@ import {describe, it, expect, vi, beforeEach, afterEach} from 'vitest';
import fs from 'fs';
import path from 'path';
import os from 'os';
import {serialize, format_from_ext, print} from '../../utils/output';

const mocks = vi.hoisted(()=>({
get_config: vi.fn(),
}));
vi.mock('../../utils/config', ()=>({
get: mocks.get_config,
}));

import {serialize, format_from_ext, print} from '../../utils/output';
describe('utils/output.serialize csv', ()=>{
beforeEach(()=>{
mocks.get_config.mockReturnValue(true);
});
afterEach(()=>{
mocks.get_config.mockReset();
});
it('serializes array of flat objects as RFC 4180 CSV with header row', ()=>{
const rows = [
{url: 'https://a.test/1', title: 'A', price: 1.5},
Expand DownExpand Up@@ -46,6 +59,42 @@ describe('utils/output.serialize csv', ()=>{
const lines = out.trim().split('\n');
expect(lines[1]).toBe('1,"{""tag"":""x""}"');
});
it('sanitizes spreadsheet formula prefixes in CSV string cells', ()=>{
const rows = [{
equals: '=1+1',
space: ' =1+1',
multi_space: ' =1+1',
tab: '\t=1+1',
nbsp: '\u00a0=1+1',
plus: '+cmd',
minus: '-SUM(A1:A2)',
at: '@SUM(A1:A2)',
}];
const out = serialize(rows, 'csv');
expect(out).toContain("'=1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("' =1+1");
expect(out).toContain("'\t=1+1");
expect(out).toContain("'\u00a0=1+1");
expect(out).toContain("'+cmd");
expect(out).toContain("'-SUM(A1:A2)");
expect(out).toContain("'@SUM(A1:A2)");
});
it('does not sanitize numeric values', ()=>{
const out = serialize([{value: -100}], 'csv');
const lines = out.trim().split('\n');
expect(lines[1]).toBe('-100');
});
it('preserves numeric-looking CSV strings', ()=>{
const out = serialize([{negative: '-100', positive: '+15'}], 'csv');
expect(out).toContain('-100,+15');
});
it('does not sanitize CSV cells when sanitize_csv is false', ()=>{
mocks.get_config.mockReturnValue(false);
const out = serialize([{value: '=1+1'}], 'csv');
expect(out).toContain('=1+1');
expect(out).not.toContain("'=1+1");
});
});

describe('utils/output.serialize markdown', ()=>{
Expand Down
15 changes: 13 additions & 2 deletions src/commands/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -14,6 +14,7 @@ const CONFIG_KEYS: Config_key[] = [
'default_zone_serp',
'default_format',
'api_url',
'sanitize_csv',
];

const format_keys = ()=>CONFIG_KEYS.join(', ');
Expand DownExpand Up@@ -50,12 +51,22 @@ const handle_get_config = (key: string)=>{
);
return;
}
process.stdout.write(value+'\n');
process.stdout.write(String(value)+'\n');
};

const handle_set_config = (key: string, value: string)=>{
const valid_key = ensure_valid_key(key);
set_config(valid_key, value);
if (valid_key == 'sanitize_csv')
{
if (value != 'true' && value != 'false')
{
fail('sanitize_csv must be true or false');
return;
}
set_config(valid_key, value == 'true');
}
else
set_config(valid_key, value);
success(`Config updated: ${valid_key}=${value}`);
};

Expand Down
12 changes: 9 additions & 3 deletions src/utils/config.ts
Original file line numberDiff line numberDiff line change
Expand Up@@ -9,11 +9,17 @@ type Config = {
default_zone_serp?: string;
default_format?: string;
api_url?: string;
sanitize_csv?: boolean;
};

type String_config_key = {
[K in keyof Config]-?: Config[K] extends string|undefined ? K : never
}[keyof Config];

const DEFAULTS: Config = {
default_format: 'markdown',
api_url: 'https://api.brightdata.com',
sanitize_csv: true,
};

const load = (): Config=>{
Expand All@@ -35,12 +41,12 @@ const save = (config: Config)=>{
fs.writeFileSync(get_config_path(), JSON.stringify(config, null, 4));
};

const get = (key: keyof Config): string|undefined=>{
const get = <K extends keyof Config>(key: K): Config[K]=>{
const config = load();
return config[key];
};

const set = (key: keyof Config, value: string)=>{
const set = <K extends keyof Config>(key: K, value: Config[K])=>{
const config = load();
config[key] = value;
save(config);
Expand All@@ -50,7 +56,7 @@ const set = (key: keyof Config, value: string)=>{
const resolve = (
cli_val: string|undefined,
env_key: string,
config_key: keyof Config
config_key: String_config_key
): string|undefined=>{
if (cli_val)
return cli_val;
Expand Down
17 changes: 15 additions & 2 deletions src/utils/output.ts
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
import fs from 'fs';
import path from 'path';

import {get as get_config} from './config';

const is_tty = process.stdout.isTTY === true;

const ansi = (code: string, text: string)=>
Expand DownExpand Up@@ -84,10 +86,21 @@ const cell_to_string = (val: unknown): string=>{
return JSON.stringify(val);
};

const sanitize_csv_cell = (s: string): string=>{

@artemo-brdartemo-brdAug 31, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add a global sanitize_csv configuration option that users can set with:

brightdata config set sanitize_csv false
brightdata config set sanitize_csv true

It should default to true. Since config values currently enter through the CLI as strings, please validate and convert "true"/"false" to actual booleans when setting or reading this option; "false" must not be treated as a truthy string. Other values should be rejected.

We can add per-command overrides later if needed (scrape, search, pipelines, discover, scraper, browser),

const trimmed = s.trim();
if (/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)$/.test(trimmed))
return s;
if (/^[\s\u00a0]*[=+\-@]/.test(s))
return "'" + s;
return s;
};

const csv_escape = (val: unknown): string=>{
const s = cell_to_string(val);
let s = cell_to_string(val);
if (typeof val == 'string' && get_config('sanitize_csv') !== false)
s = sanitize_csv_cell(s);
if (/[",\r\n]/.test(s))
return '"'+s.replace(/"/g, '""')+'"';
return '"' + s.replace(/"/g, '""') + '"';
return s;
};

Expand Down