bump: version 2.1.0 → 2.2.0

Author: 3-Tokisaki-Kurumi

CHANGELOG.md

@@ -1,3 +1,16 @@
+## 2.2.0 (2025-06-15)
+
+### Feat
+
+- **fingerprint**: add comprehensive browser fingerprint spoofing capabilities
+- **fingerprint**: add FingerprintConfig class for customizable fingerprint settings
+- **fingerprint**: add FingerprintManager for persistent fingerprint storage and reuse
+- **fingerprint**: add support for spoofing user agent, screen resolution, hardware specs
+- **fingerprint**: add WebGL, Canvas, Audio, and WebRTC fingerprint spoofing
+- **fingerprint**: add fingerprint spoofing support for Chrome and Edge browsers
+- **fingerprint**: add multiple browsers with different fingerprints capability
+- **fingerprint**: add fingerprint persistence across browser sessions
+
 ## 2.1.0 (2025-06-14)
 
 ### Feat

examples/fingerprint_example.py

@@ -1,7 +1,7 @@
 """
-指纹伪装功能示例
+Fingerprint Spoofing Feature Examples
 
-演示如何使用 pydoll 的指纹伪装功能来防止浏览器指纹追踪。
+Demonstrates how to use pydoll's fingerprint spoofing features to prevent browser fingerprint tracking.
 """
 
 import asyncio
@@ -10,48 +10,48 @@
 
 
 async def basic_example():
-    """基础示例：一键启用指纹伪装"""
-    print("=== 基础示例：一键启用指纹伪装 ===")
+    """Basic example: Enable fingerprint spoofing with one click"""
+    print("=== Basic Example: Enable Fingerprint Spoofing ===")
 
-    # 创建启用了指纹伪装的 Chrome 浏览器
+    # Create Chrome browser with fingerprint spoofing enabled
     browser = Chrome(enable_fingerprint_spoofing=True)
 
     async with browser:
-        # 启动浏览器
+        # Start browser
         tab = await browser.start()
 
-        # 访问指纹检测网站
+        # Visit fingerprint detection website
         await tab.go_to("https://fingerprintjs.github.io/fingerprintjs/")
 
-        # 等待页面加载
+        # Wait for page to load
         await asyncio.sleep(5)
 
-        # 获取指纹 ID
+        # Get fingerprint ID
         try:
             fingerprint_element = await tab.find_element("css", ".visitor-id")
             if fingerprint_element:
                 fingerprint_id = await fingerprint_element.text
-                print(f"生成的指纹 ID: {fingerprint_id}")
+                print(f"Generated fingerprint ID: {fingerprint_id}")
         except Exception as e:
-            print(f"获取指纹 ID 失败: {e}")
+            print(f"Failed to get fingerprint ID: {e}")
 
-        # 截图保存结果
+        # Take screenshot to save result
         try:
             await tab.take_screenshot("fingerprint_result.png")
-            print("截图已保存为 fingerprint_result.png")
+            print("Screenshot saved as fingerprint_result.png")
         except Exception as e:
-            print(f"截图失败: {e}")
+            print(f"Screenshot failed: {e}")
 
         await asyncio.sleep(3)
 
 
 async def custom_config_example():
-    """高级示例：自定义指纹配置"""
-    print("\n=== 高级示例：自定义指纹配置 ===")
+    """Advanced example: Custom fingerprint configuration"""
+    print("\n=== Advanced Example: Custom Fingerprint Configuration ===")
 
-    # 创建自定义指纹配置
+    # Create custom fingerprint configuration
     config = FingerprintConfig(
-        # 选择要伪装的功能
+        # Select features to spoof
         spoof_user_agent=True,
         spoof_screen=True,
         spoof_hardware=True,
@@ -60,15 +60,15 @@ async def custom_config_example():
         spoof_audio=True,
         spoof_webrtc=True,
 
-        # 自定义设置
+        # Custom settings
         browser_type="chrome",
         os_type="windows",
         device_type="desktop",
         custom_languages=["zh-CN", "zh", "en-US", "en"],
         custom_screen_resolution=(2560, 1440),
     )
 
-    # 创建浏览器实例
+    # Create browser instance
     browser = Chrome(
         enable_fingerprint_spoofing=True,
         fingerprint_config=config
@@ -77,12 +77,12 @@ async def custom_config_example():
     async with browser:
         tab = await browser.start()
 
-        # 访问浏览器信息检测网站
+        # Visit browser information detection website
         await tab.go_to("https://browserleaks.com/javascript")
 
         await asyncio.sleep(5)
 
-        # 获取并打印一些浏览器信息
+        # Get and print some browser information
         try:
             user_agent = await tab.execute_script("return navigator.userAgent")
             print(f"User Agent: {user_agent}")
@@ -97,28 +97,28 @@ async def custom_config_example():
                     colorDepth: screen.colorDepth
                 }
             """)
-            print(f"屏幕信息: {screen_info}")
+            print(f"Screen info: {screen_info}")
         except Exception as e:
-            print(f"获取浏览器信息失败: {e}")
+            print(f"Failed to get browser information: {e}")
 
         await asyncio.sleep(3)
 
 
 async def persistent_fingerprint_example():
-    """持久化指纹示例：保存和重用指纹"""
-    print("\n=== 持久化指纹示例 ===")
+    """Persistent fingerprint example: Save and reuse fingerprints"""
+    print("\n=== Persistent Fingerprint Example ===")
 
-    # 创建指纹管理器
+    # Create fingerprint manager
     fingerprint_manager = FingerprintManager()
 
-    # 配置持久化指纹
+    # Configure persistent fingerprint
     config = FingerprintConfig(
         persist_fingerprint=True,
         fingerprint_id="my_persistent_fingerprint"
     )
 
-    # 第一次使用：生成并保存指纹
-    print("第一次访问：生成新指纹")
+    # First use: Generate and save fingerprint
+    print("First visit: Generate new fingerprint")
     browser1 = Chrome(
         enable_fingerprint_spoofing=True,
         fingerprint_config=config
@@ -129,46 +129,46 @@ async def persistent_fingerprint_example():
         await tab.go_to("https://amiunique.org/fingerprint")
         await asyncio.sleep(5)
 
-        # 获取当前指纹
+        # Get current fingerprint
         current_fingerprint = fingerprint_manager.current_fingerprint
         if current_fingerprint:
-            print(f"当前 User Agent: {current_fingerprint.user_agent}")
-            print(f"当前平台: {current_fingerprint.platform}")
+            print(f"Current User Agent: {current_fingerprint.user_agent}")
+            print(f"Current platform: {current_fingerprint.platform}")
 
-    # 第二次使用：加载已保存的指纹
-    print("\n第二次访问：使用相同的指纹")
+    # Second use: Load saved fingerprint
+    print("\nSecond visit: Use same fingerprint")
 
-    # 加载之前保存的指纹
+    # Load previously saved fingerprint
     saved_fingerprint = fingerprint_manager.load_fingerprint("my_persistent_fingerprint")
     if saved_fingerprint:
-        print(f"加载的 User Agent: {saved_fingerprint.user_agent}")
-        print(f"加载的平台: {saved_fingerprint.platform}")
+        print(f"Loaded User Agent: {saved_fingerprint.user_agent}")
+        print(f"Loaded platform: {saved_fingerprint.platform}")
 
-    # 列出所有保存的指纹
+    # List all saved fingerprints
     all_fingerprints = fingerprint_manager.list_fingerprints()
-    print(f"\n所有保存的指纹: {list(all_fingerprints.keys())}")
+    print(f"\nAll saved fingerprints: {list(all_fingerprints.keys())}")
 
 
 async def multiple_browsers_example():
-    """多浏览器示例：同时运行多个不同指纹的浏览器"""
-    print("\n=== 多浏览器示例 ===")
+    """Multiple browsers example: Run multiple browsers with different fingerprints simultaneously"""
+    print("\n=== Multiple Browsers Example ===")
 
-    # 创建两个不同指纹的浏览器
+    # Create two browsers with different fingerprints
     browser1 = Chrome(enable_fingerprint_spoofing=True)
     browser2 = Chrome(enable_fingerprint_spoofing=True)
 
     async with browser1, browser2:
-        # 启动两个浏览器
+        # Start both browsers
         tab1 = await browser1.start()
         tab2 = await browser2.start()
 
-        # 都访问同一个指纹检测网站
+        # Both visit the same fingerprint detection website
         await tab1.go_to("https://fingerprintjs.github.io/fingerprintjs/")
         await tab2.go_to("https://fingerprintjs.github.io/fingerprintjs/")
 
         await asyncio.sleep(5)
 
-        # 获取两个浏览器的指纹 ID
+        # Get fingerprint IDs from both browsers
         try:
             fp_element1 = await tab1.find_element("css", ".visitor-id")
             fp_element2 = await tab2.find_element("css", ".visitor-id")
@@ -177,24 +177,24 @@ async def multiple_browsers_example():
                 fp_id1 = await fp_element1.text
                 fp_id2 = await fp_element2.text
 
-                print(f"浏览器 1 指纹 ID: {fp_id1}")
-                print(f"浏览器 2 指纹 ID: {fp_id2}")
+                print(f"Browser 1 fingerprint ID: {fp_id1}")
+                print(f"Browser 2 fingerprint ID: {fp_id2}")
 
                 if fp_id1 != fp_id2:
-                    print("✓ 成功：两个浏览器生成了不同的指纹！")
+                    print("✓ Success: Two browsers generated different fingerprints!")
                 else:
-                    print("✗ 警告：两个浏览器的指纹相同")
+                    print("✗ Warning: Both browsers have the same fingerprint")
         except Exception as e:
-            print(f"获取指纹 ID 失败: {e}")
+            print(f"Failed to get fingerprint ID: {e}")
 
         await asyncio.sleep(3)
 
 
 async def edge_browser_example():
-    """Edge 浏览器示例"""
-    print("\n=== Edge 浏览器示例 ===")
+    """Edge browser example"""
+    print("\n=== Edge Browser Example ===")
 
-    # 创建启用了指纹伪装的 Edge 浏览器
+    # Create Edge browser with fingerprint spoofing enabled
     browser = Edge(enable_fingerprint_spoofing=True)
 
     async with browser:
@@ -203,7 +203,7 @@ async def edge_browser_example():
         await tab.go_to("https://www.whatismybrowser.com/")
         await asyncio.sleep(5)
 
-        # 检查浏览器识别
+        # Check browser identification
         try:
             browser_info = await tab.execute_script("""
                 return {
@@ -213,37 +213,37 @@ async def edge_browser_example():
                 }
             """)
 
-            print(f"Edge 浏览器信息: {browser_info}")
+            print(f"Edge browser info: {browser_info}")
         except Exception as e:
-            print(f"获取浏览器信息失败: {e}")
+            print(f"Failed to get browser information: {e}")
 
         await asyncio.sleep(3)
 
 
 async def main():
-    """运行所有示例"""
+    """Run all examples"""
     try:
-        # 运行基础示例
+        # Run basic example
         await basic_example()
 
-        # 运行自定义配置示例
+        # Run custom configuration example
         await custom_config_example()
 
-        # 运行持久化指纹示例
+        # Run persistent fingerprint example
         await persistent_fingerprint_example()
 
-        # 运行多浏览器示例
+        # Run multiple browsers example
         await multiple_browsers_example()
 
-        # 运行 Edge 浏览器示例
+        # Run Edge browser example
         await edge_browser_example()
 
     except Exception as e:
-        print(f"运行示例时出错: {e}")
+        print(f"Error running examples: {e}")
         import traceback
         traceback.print_exc()
 
 
 if __name__ == "__main__":
-    # 运行示例
+    # Run examples
     asyncio.run(main())