find_files

find_files(directory, options?): Promise<File[]>

Defined in: packages/pleco-xa/src/scripts/xa-fileio.js:190

Get a sorted list of audio files using File System Access API

Allows users to select a directory and find all audio files within it. Uses the File System Access API (Chrome 86+, Edge 86+) for directory access. Falls back to input element for older browsers.

Parameters

directory

any

Directory handle (or a DirectoryHandle-shaped object in non-browser environments), or the string ‘select’ to open the browser picker

options?

Search options

caseSensitive

boolean

Case-sensitive extension matching (default: false)

ext

string | string[]

File extensions to match (default: common audio formats)

limit

number

Maximum number of files to return (default: null, no limit)

offset

number

Skip first N files (default: 0)

recurse

boolean

Search subdirectories recursively (default: true)

Returns

Promise<File[]>

Sorted list of audio File objects

Examples

// Find all audio files in a user-selected directory
const audioFiles = await find_files('select', {
  ext: ['.mp3', '.wav', '.ogg', '.flac'],
  recurse: true,
  limit: 100
});

console.log(`Found ${audioFiles.length} audio files`);
audioFiles.forEach(file => console.log(file.name));

// Find files with Directory Handle
const dirHandle = await window.showDirectoryPicker();
const files = await find_files(dirHandle, {
  ext: '.wav',
  recurse: false
});