arn-browser 0.1.37 → 0.1.39

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "arn-browser",
-	"version": "0.1.37",
+	"version": "0.1.39",
 	"description": "A lightweight, browser autmation helper.",
 	"main": "src/index.js",
 	"types": "src/index.d.ts",

package/src/utility/playwright/pwLaunch.d.ts

@@ -87,9 +87,15 @@ export interface MultiloginOptions {
 
 	/**
 	 * OS Type for Multilogin profile creation.
+	 * - Single string: uses that OS
+	 * - Array: random pick per launch (e.g. ["windows", "android"])
+	 * - Omitted/null: auto-detects from process.platform
+	 *
+	 * Note: When "android" is selected, screen_masking is forced to true.
+	 *
 	 * Default: detected OS
 	 */
-	os_type?: "windows" | "macos" | "linux" | "android";
+	os_type?: ("windows" | "macos" | "linux" | "android") | ("windows" | "macos" | "linux" | "android")[];
 
 	/**
 	 * Multilogin flag: Canvas noise masking.
@@ -113,6 +119,7 @@ export interface MultiloginOptions {
 	 * Multilogin flag: Screen resolution masking.
 	 * true = randomize screen resolution ("mask")
 	 * false = use real screen resolution ("natural")
+	 * Note: Forced to true when os_type is "android".
 	 * Default: true
 	 */
 	screen_masking?: boolean;

package/src/utility/playwright/pwLaunch.js

@@ -979,7 +979,7 @@ async function multiloginLauncher({ proxy, multilogin_options = {}, humanize_opt
 	// Destructure defaults from multilogin_options
 	const {
 		profileId = null,
-		os_type = detectedOs,
+		os_type: rawOsType = null,
 		canvas_noise = true,
 		media_masking = true,
 		audio_masking = true,
@@ -988,17 +988,33 @@ async function multiloginLauncher({ proxy, multilogin_options = {}, humanize_opt
 
 	if (profileId) {
 		return await launchExistingMultiloginProfile(profileId, humanize_options);
+	}
+
+	// Resolve os_type: array → random pick, null → detect from process.platform
+	let selectedOs;
+
+	if (Array.isArray(rawOsType) && rawOsType.length > 0) {
+		selectedOs = rawOsType[Math.floor(Math.random() * rawOsType.length)];
+	} else if (typeof rawOsType === "string" && rawOsType) {
+		selectedOs = rawOsType;
 	} else {
-		return await launchQuickMultiloginProfile({
-			os_type,
-			proxy,
-			canvas_noise,
-			media_masking,
-			audio_masking,
-			screen_masking,
-			humanize_options,
-		});
+		selectedOs = detectedOs;
 	}
+
+	// Android always forces screen_masking to true
+	const effectiveScreenMasking = selectedOs === "android" ? true : screen_masking;
+
+	if (_launchLogs) console.log(`░░░░░ Multilogin OS: ${selectedOs} (screen_masking: ${effectiveScreenMasking})`);
+
+	return await launchQuickMultiloginProfile({
+		os_type: selectedOs,
+		proxy,
+		canvas_noise,
+		media_masking,
+		audio_masking,
+		screen_masking: effectiveScreenMasking,
+		humanize_options,
+	});
 }
 
 async function launchExistingMultiloginProfile(profileId, humanize_options = null) {
@@ -1088,11 +1104,28 @@ async function launchQuickMultiloginProfile({ os_type, proxy, canvas_noise, medi
 		is_headless: false,
 		parameters: {
 			flags: {
+				navigator_masking: "mask",
 				audio_masking: audio_masking ? "mask" : "natural",
+				localization_masking: "mask",
+				geolocation_popup: "prompt",
+				geolocation_masking: "mask",
+				timezone_masking: "mask",
+				graphics_noise: "mask",
+				graphics_masking: "mask",
+				webrtc_masking: "mask",
+				fonts_masking: "mask",
 				media_devices_masking: media_masking ? "mask" : "natural",
 				screen_masking: screen_masking ? "mask" : "natural",
-				canvas_noise: canvas_noise ? "mask" : "natural",
 				proxy_masking: proxy ? "custom" : "disabled",
+				ports_masking: "mask",
+				canvas_noise: canvas_noise ? "mask" : "natural",
+				startup_behavior: "custom",
+			},
+			fingerprint: {
+				ports: [],
+				cmd_params: {
+					params: [{ flag: "warn-on-window-close" }],
+				},
 			},
 		},
 		quickProfilesCount: 1,

package/src/utility/puppeteer/ppLaunch.d.ts

@@ -12,9 +12,15 @@ export interface PpMultiloginOptions {
 
 	/**
 	 * OS Type for Multilogin profile creation.
+	 * - Single string: uses that OS
+	 * - Array: random pick per launch (e.g. ["windows", "android"])
+	 * - Omitted/null: auto-detects from process.platform
+	 *
+	 * Note: When "android" is selected, screen_masking is forced to true.
+	 *
 	 * Default: detected OS
 	 */
-	os_type?: "windows" | "macos" | "linux" | "android";
+	os_type?: ("windows" | "macos" | "linux" | "android") | ("windows" | "macos" | "linux" | "android")[];
 
 	/**
 	 * Multilogin flag: Canvas noise masking.
@@ -38,6 +44,7 @@ export interface PpMultiloginOptions {
 	 * Multilogin flag: Screen resolution masking.
 	 * true = randomize screen resolution ("mask")
 	 * false = use real screen resolution ("natural")
+	 * Note: Forced to true when os_type is "android".
 	 * Default: true
 	 */
 	screen_masking?: boolean;

package/src/utility/puppeteer/ppLaunch.js

@@ -709,7 +709,7 @@ async function spawnAndConnect({ binaryPath, profilePath, isPersistent, proxy, t
 async function multiloginLauncher({ proxy, multilogin_options = {} }) {
 	const {
 		profileId = null,
-		os_type = (process.platform === "win32" ? "windows" : process.platform === "darwin" ? "macos" : "linux"),
+		os_type: rawOsType = null,
 		canvas_noise = true,
 		media_masking = true,
 		audio_masking = true,
@@ -718,16 +718,33 @@ async function multiloginLauncher({ proxy, multilogin_options = {} }) {
 
 	if (profileId) {
 		return await launchExistingMultiloginProfile(profileId);
+	}
+
+	// Resolve os_type: array → random pick, null → detect from process.platform
+	const defaultOs = process.platform === "win32" ? "windows" : process.platform === "darwin" ? "macos" : "linux";
+	let selectedOs;
+
+	if (Array.isArray(rawOsType) && rawOsType.length > 0) {
+		selectedOs = rawOsType[Math.floor(Math.random() * rawOsType.length)];
+	} else if (typeof rawOsType === "string" && rawOsType) {
+		selectedOs = rawOsType;
 	} else {
-		return await launchQuickMultiloginProfile({
-			os_type,
-			proxy,
-			canvas_noise,
-			media_masking,
-			audio_masking,
-			screen_masking,
-		});
+		selectedOs = defaultOs;
 	}
+
+	// Android always forces screen_masking to true
+	const effectiveScreenMasking = selectedOs === "android" ? true : screen_masking;
+
+	if (_launchLogs) console.log(`░░░░░ Multilogin OS: ${selectedOs} (screen_masking: ${effectiveScreenMasking})`);
+
+	return await launchQuickMultiloginProfile({
+		os_type: selectedOs,
+		proxy,
+		canvas_noise,
+		media_masking,
+		audio_masking,
+		screen_masking: effectiveScreenMasking,
+	});
 }
 
 async function launchExistingMultiloginProfile(profileId) {
@@ -816,11 +833,28 @@ async function launchQuickMultiloginProfile({ os_type, proxy, canvas_noise, medi
 		is_headless: false,
 		parameters: {
 			flags: {
+				navigator_masking: "mask",
 				audio_masking: audio_masking ? "mask" : "natural",
+				localization_masking: "mask",
+				geolocation_popup: "prompt",
+				geolocation_masking: "mask",
+				timezone_masking: "mask",
+				graphics_noise: "mask",
+				graphics_masking: "mask",
+				webrtc_masking: "mask",
+				fonts_masking: "mask",
 				media_devices_masking: media_masking ? "mask" : "natural",
 				screen_masking: screen_masking ? "mask" : "natural",
-				canvas_noise: canvas_noise ? "mask" : "natural",
 				proxy_masking: proxy ? "custom" : "disabled",
+				ports_masking: "mask",
+				canvas_noise: canvas_noise ? "mask" : "natural",
+				startup_behavior: "custom",
+			},
+			fingerprint: {
+				ports: [],
+				cmd_params: {
+					params: [{ flag: "warn-on-window-close" }],
+				},
 			},
 		},
 		quickProfilesCount: 1,