Math & Text
removeLinks
$removeLinks
The $removeLinks[Text] function returns the given text without its http:// and https:// links. Without argument, $removeLinks is a flag that removes the links from the whole message sent by the script.
Syntax
$removeLinks[Text]
Parameters
| Parameter | Description |
|---|---|
Text |
Optional. The text to clean. With it, the function returns that text without its links and filters nothing else. |
More than one argument is refused (“Invalid argument count”).
Return Value
- Type: String
- With
Text: the text without its links. - Without argument (
$removeLinks): always an empty string; it only sets the flag.
Behavior
- With an argument: only the given text is cleaned; the rest of the message is not filtered.
- Without argument: the flag applies to the whole script output, whether
$removeLinksis written before or after the text. - A link is detected case-insensitively when it starts with
http://orhttps://. The match runs up to the next space, line break,<or>, so punctuation stuck to the link goes with it:(https://a.b/c).becomes(. - Links without
http://orhttps://(www.x.com,discord.gg/abc,ftp://...) are not removed. - It is not applied to messages sent by
$sendMessage[]or$channelSendMessage[], nor to embed fields ($title,$description…): their links are kept. - The flag (bare form) is reset at the start of each script execution.
Examples
Clean a given text
$removeLinks[Visit https://spam.com now]
The message sent is Visit now (the two spaces around the removed link remain).
Echo only the cleaned user text
Your text: $removeLinks[$message]
Only $message is cleaned; Your text: is untouched.
Anti-spam cleanup of the whole message (flag)
$removeLinks
Visit https://spam.com now
The message sent is Visit now.
Notes
$ignoreLinksis accepted but does nothing in this engine; it is not a way to block links.- To remove another piece of text, use
$removeContains[].
Try it
Paste an example into the playground to preview its message (functions that act on Discord are not run), or build the same thing with blocks.