Skip to content

rnet.emulation

Browser and client emulation settings to bypass detection and fingerprinting.

rnet.emulation

This module provides functionality for emulating various browsers and HTTP clients to bypass detection and fingerprinting. It supports emulating Chrome, Firefox, Edge, Safari, Opera, and OkHttp clients across different operating systems and versions.

The emulation system modifies HTTP/2 settings, TLS fingerprints, and request headers to match the behavior of real browsers and clients, making requests appear more authentic and less likely to be blocked by anti-bot systems.

Emulation

Bases: Enum

An emulation.

Source code in rnet/emulation.py 
 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
@final
class Emulation(Enum):
    r"""
    An emulation.
    """

    # Chrome versions
    Chrome100 = auto()
    Chrome101 = auto()
    Chrome104 = auto()
    Chrome105 = auto()
    Chrome106 = auto()
    Chrome107 = auto()
    Chrome108 = auto()
    Chrome109 = auto()
    Chrome110 = auto()
    Chrome114 = auto()
    Chrome116 = auto()
    Chrome117 = auto()
    Chrome118 = auto()
    Chrome119 = auto()
    Chrome120 = auto()
    Chrome123 = auto()
    Chrome124 = auto()
    Chrome126 = auto()
    Chrome127 = auto()
    Chrome128 = auto()
    Chrome129 = auto()
    Chrome130 = auto()
    Chrome131 = auto()
    Chrome132 = auto()
    Chrome133 = auto()
    Chrome134 = auto()
    Chrome135 = auto()
    Chrome136 = auto()
    Chrome137 = auto()
    Chrome138 = auto()
    Chrome139 = auto()
    Chrome140 = auto()
    Chrome141 = auto()
    Chrome142 = auto()
    Chrome143 = auto()

    # Microsoft Edge versions
    Edge101 = auto()
    Edge122 = auto()
    Edge127 = auto()
    Edge131 = auto()
    Edge134 = auto()
    Edge135 = auto()
    Edge136 = auto()
    Edge137 = auto()
    Edge138 = auto()
    Edge139 = auto()
    Edge140 = auto()
    Edge141 = auto()
    Edge142 = auto()

    # Firefox versions
    Firefox109 = auto()
    Firefox117 = auto()
    Firefox128 = auto()
    Firefox133 = auto()
    Firefox135 = auto()
    FirefoxPrivate135 = auto()
    FirefoxAndroid135 = auto()
    Firefox136 = auto()
    FirefoxPrivate136 = auto()
    Firefox139 = auto()
    Firefox142 = auto()
    Firefox143 = auto()
    Firefox144 = auto()
    Firefox145 = auto()
    Firefox146 = auto()

    # Safari versions
    SafariIos17_2 = auto()
    SafariIos17_4_1 = auto()
    SafariIos16_5 = auto()
    Safari15_3 = auto()
    Safari15_5 = auto()
    Safari15_6_1 = auto()
    Safari16 = auto()
    Safari16_5 = auto()
    Safari17_0 = auto()
    Safari17_2_1 = auto()
    Safari17_4_1 = auto()
    Safari17_5 = auto()
    Safari18 = auto()
    SafariIPad18 = auto()
    Safari18_2 = auto()
    Safari18_3 = auto()
    Safari18_3_1 = auto()
    SafariIos18_1_1 = auto()
    Safari18_5 = auto()
    Safari26 = auto()
    Safari26_1 = auto()
    Safari26_2 = auto()
    SafariIos26 = auto()
    SafariIos26_2 = auto()
    SafariIPad26 = auto()
    SafariIpad26_2 = auto()

    # OkHttp versions
    OkHttp3_9 = auto()
    OkHttp3_11 = auto()
    OkHttp3_13 = auto()
    OkHttp3_14 = auto()
    OkHttp4_9 = auto()
    OkHttp4_10 = auto()
    OkHttp4_12 = auto()
    OkHttp5 = auto()

    # Opera versions
    Opera116 = auto()
    Opera117 = auto()
    Opera118 = auto()
    Opera119 = auto()

EmulationOS

Bases: Enum

Operating systems that can be emulated.

This enum defines the operating systems that can be combined with browser emulations to create more specific fingerprints.

Source code in rnet/emulation.py 
137
138
139
140
141
142
143
144
145
146
147
148
149
150
@final
class EmulationOS(Enum):
    """
    Operating systems that can be emulated.

    This enum defines the operating systems that can be combined with
    browser emulations to create more specific fingerprints.
    """

    Windows = auto()  # Windows (any version)
    MacOS = auto()  # macOS (any version)
    Linux = auto()  # Linux (any distribution)
    Android = auto()  # Android (mobile)
    IOS = auto()  # iOS (iPhone/iPad)

EmulationOption

Configuration options for browser and client emulation.

This class allows fine-grained control over emulation behavior, including the ability to disable specific features or combine browser types with specific operating systems.

Source code in rnet/emulation.py 
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
@final
class EmulationOption:
    """
    Configuration options for browser and client emulation.

    This class allows fine-grained control over emulation behavior,
    including the ability to disable specific features or combine
    browser types with specific operating systems.
    """

    def __init__(
        self,
        emulation: Emulation,
        emulation_os: EmulationOS | None = None,
        skip_http2: bool | None = None,
        skip_headers: bool | None = None,
    ) -> None:
        """
        Create a new emulation configuration.

        Args:
            emulation: The browser/client type to emulate
            emulation_os: The operating system to emulate (optional)
            skip_http2: Whether to disable HTTP/2 emulation (default: False)
            skip_headers: Whether to skip default browser headers (default: False)

        Returns:
            A configured EmulationOption instance

        Example:
            ```python
            # Basic Chrome emulation
            option = EmulationOption(Emulation.Chrome137)

            # Chrome on Windows with HTTP/2 disabled
            option = EmulationOption(
                emulation=Emulation.Chrome137,
                emulation_os=EmulationOS.Windows,
                skip_http2=True
            )
            ```
        """
        ...

    @staticmethod
    def random() -> "EmulationOption":
        """
        Generate a random emulation configuration.

        This method creates a randomized emulation setup using a random
        browser/client type and operating system combination. Useful for
        scenarios where you want to vary your fingerprint across requests.

        Returns:
            A randomly configured EmulationOption instance

        Example:
            ```python
            # Use different random emulation for each client
            client1 = rnet.Client(emulation=EmulationOption.random())
            client2 = rnet.Client(emulation=EmulationOption.random())
            ```
        """
        ...

__init__ 

__init__(emulation, emulation_os=None, skip_http2=None, skip_headers=None)

Create a new emulation configuration.

Parameters:

Name Type Description Default
emulation Emulation

The browser/client type to emulate

 required
emulation_os EmulationOS | None

The operating system to emulate (optional)

 None
skip_http2 bool | None

Whether to disable HTTP/2 emulation (default: False)

 None
skip_headers bool | None

Whether to skip default browser headers (default: False)

 None

Returns:

Type Description
None

A configured EmulationOption instance
Example 
# Basic Chrome emulation
option = EmulationOption(Emulation.Chrome137)

# Chrome on Windows with HTTP/2 disabled
option = EmulationOption(
    emulation=Emulation.Chrome137,
    emulation_os=EmulationOS.Windows,
    skip_http2=True
)
Source code in rnet/emulation.py 
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
def __init__(
    self,
    emulation: Emulation,
    emulation_os: EmulationOS | None = None,
    skip_http2: bool | None = None,
    skip_headers: bool | None = None,
) -> None:
    """
    Create a new emulation configuration.

    Args:
        emulation: The browser/client type to emulate
        emulation_os: The operating system to emulate (optional)
        skip_http2: Whether to disable HTTP/2 emulation (default: False)
        skip_headers: Whether to skip default browser headers (default: False)

    Returns:
        A configured EmulationOption instance

    Example:
        ```python
        # Basic Chrome emulation
        option = EmulationOption(Emulation.Chrome137)

        # Chrome on Windows with HTTP/2 disabled
        option = EmulationOption(
            emulation=Emulation.Chrome137,
            emulation_os=EmulationOS.Windows,
            skip_http2=True
        )
        ```
    """
    ...

random staticmethod 

random()

Generate a random emulation configuration.

This method creates a randomized emulation setup using a random browser/client type and operating system combination. Useful for scenarios where you want to vary your fingerprint across requests.

Returns:

Type Description
EmulationOption

A randomly configured EmulationOption instance
Example 
# Use different random emulation for each client
client1 = rnet.Client(emulation=EmulationOption.random())
client2 = rnet.Client(emulation=EmulationOption.random())
Source code in rnet/emulation.py 
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
@staticmethod
def random() -> "EmulationOption":
    """
    Generate a random emulation configuration.

    This method creates a randomized emulation setup using a random
    browser/client type and operating system combination. Useful for
    scenarios where you want to vary your fingerprint across requests.

    Returns:
        A randomly configured EmulationOption instance

    Example:
        ```python
        # Use different random emulation for each client
        client1 = rnet.Client(emulation=EmulationOption.random())
        client2 = rnet.Client(emulation=EmulationOption.random())
        ```
    """
    ...