Skip to main content


The Telegram Bot Framework.
Very Popular
Go to Latest
function matchFilter
import { matchFilter } from "";

This is an advanced function of grammY.

Takes a filter query and turns it into a predicate function that can check in constant time whether a given context object satisfies the query. The created predicate can be passed to bot.filter and will narrow down the context accordingly.

This function is used internally by bot.on but exposed for advanced usage like the following.

// Listens for updates except forwards of messages or channel posts
bot.drop(matchFilter(':forward_date'), ctx => { ... })

Check out the documentation of bot.on for examples. In addition, the website contains more information about how filter queries work in grammY.


filter: Q | Q[]

A filter query or an array of filter queries


FilterFunction<C, Filter<C, Q>>