delete

Used to delete the request URL, request/response headers, and request/response content.

Rule Syntax

pattern delete://prop1|prop2|... [filters...]

# Equivalent to:
pattern delete://prop1 delete://prop2 ... [filters...]

The separator is either | or &

Configuration Example

https://www.example.com/path delete://reqCookies.token|resCookies.token

https://raw.githubusercontent.com/avwo/whistle/refs/heads/master/package.json delete://resBody.name resType://json

The above cookie deletion operation only affects cookies in the request/response process and does not modify cookies stored locally in the browser. To modify browser persistent cookies, you can do so in the following ways:

• Deleting them by injecting JavaScript using jsPrepend
• Setting cookie expiration times using resCookies

Deleting Paths

Supported versions: v2.9.102 and above

Rule Syntax

# Basic Format
Target Domain delete://pathname.index

# Example
www.example.com/api/path/to delete://pathname.0 delete://pathname.1 delete://pathname.-1

Rule Description

This rule deletes specific segments of the request URL's path. Whistle extracts the request path excluding query parameters, delimits it by /, and then deletes it.

Example Parsing:

• Request URL: https://www.example.com/api/path/to/xxx?query
• Extracted Path: api/path/to/xxx
• Split Array: ['api', 'path', 'to', 'xxx']
• Apply Rules:
  • delete://pathname.0 → Delete 'api'
  • delete://pathname.1 → Delete 'path'
  • delete://pathname.-1 → Delete 'xxx'
• Final Path: /to
• Complete Result: https://www.example.com/to?query

Indexing Rules

• Positive Index: Starting at 0, indicating order from front to back
• Negative Index: Starting at -1, indicating order from back to front (-1 = last segment, -2 = second to last segment, and so on)
• Special Value: Use last removes the last segment of a path but preserves the trailing slash.
• Border case: Out-of-range indices are ignored.

Important Note

When a path ends with /, the split array will contain an empty string item at the end:

• Path: /api/path/to/xxx/
• Split result: ['api', 'path', 'to', 'xxx', '']

Usage Tips

• Use pathname.-1 to remove the last segment without preserving the trailing slash.
• Use pathname.last to remove the last segment but preserve the trailing slash.

Comparison example:

www.example.com/api/path/to delete://pathname.0 delete://pathname.1 delete://pathname.last

• Request: https://www.example.com/api/path/to/xxx?query
• Result: https://www.example.com/to/?query (preserves the trailing slash)

Special Characters

If an object key contains the following characters, it must be escaped with a backslash \ in the path expression:

• Delimiters: | and &
• Space: (a single space)
• Dot: .
• Control characters: tab \t, newline \n, carriage return \r, form feed \f, vertical tab \v

Escape Rules

Note: The backslash \ itself is an escape character. To represent a literal backslash, it must be written as \\.

Example

Suppose you need to delete two keys from the request body:

• key1 is \n .p (contains a newline, space, dot, and the letter p)
• key2 is test|&test (contains a vertical bar and an ampersand)

The corresponding path expression should be written as:

reqBody.\n\ \.p.test\|\&test

Where:

• \n represents the newline character
• \ represents a space
• \. represents a dot
• \| represents a vertical bar
• \& represents an ampersand

Complete request example:

# Delete key1 and key2 from the request body
https://www.example.com/path delete://reqBody.\n\ \.p.test\|\&test