# LibTmux::Filter::new

- **Module:** LibTmux
- **Package:** LibTmux
- **Language:** Perl
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-perl/blob/352715a4fa66a96eed7763b90daaa536aa2f121d/packages/core/lib/LibTmux/Filter.pm#L9
- **Page:** https://libtmux.org/en/perl/latest/reference/libtmux-filter-new/

```
sub new($class, %args)
```

`new(entity => kind, where => $hashref)` validates the complete criteria tree and owns a normalized copy. Schemas choose comparison types; no scalar-history coercion or arbitrary method dispatch occurs. Errors throw [`InvalidFilter`](/en/perl/latest/reference/libtmux-x-invalidfilter/) with precise paths, even for unreachable branches.

## Methods

## Parameters

- `args`