Struct FileFilter 

pub struct FileFilter { /* private fields */ }

Declarative acceptance rules for dropped files.

Advisory, not a security boundary. These rules match on the browser- and OS-reported name, content type and size, all of which are attacker-controllable: a .exe can be renamed photo.png and report content_type: "image/png", and size is self-reported. Use the filter for UX (rejecting obviously wrong drops early), but validate the actual bytes server-side or via content sniffing before trusting a file.

Implementations

impl FileFilter

pub fn new() -> Self

pub fn extensions<I, S>(self, exts: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Allow only these extensions (case-insensitive, leading dot optional).

pub fn content_types<I, S>(self, types: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Allow only these MIME types.

Supported patterns:

• exact types: "application/pdf"
• top-level wildcards: "image/*"
• all typed files: "*/*"
• structured suffix wildcards: "application/*+json" and "*/*+json"

pub fn max_size(self, bytes: u64) -> Self

Reject files larger than this many bytes.

pub fn max_files(self, n: usize) -> Self

Accept at most this many files per drop.

pub fn check(&self, file: &FileData) -> Result<(), FileRejection>

Check a single file against the rules (ignores max_files).

pub fn partition( &self, files: Vec<FileData>, ) -> (Vec<FileData>, Vec<(FileData, FileRejection)>)

Split a batch into (accepted, rejected) applying every rule.

Trait Implementations

impl Clone for FileFilter

fn clone(&self) -> FileFilter

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FileFilter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FileFilter

fn default() -> FileFilter

Returns the “default value” for a type.

impl PartialEq for FileFilter

fn eq(&self, other: &FileFilter) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FileFilter