FbTitleFormat(expression)Performance note: if you use the same query frequently, try caching FbTitleFormat object (by storing it somewhere), instead of creating it every time.
| Name | Type | Description |
|---|---|---|
expression | string |
Eval(force)Always use Eval when you want dynamic info such as %playback_time%, %bitrate% etc.
FbTitleFormat#EvalWithMetadb(fb.GetNowplaying()) will not give the results you want.
| Name | Type | Description |
|---|---|---|
force = falseoptional | boolean | If true, you can process text that doesn't contain title formatting even when foobar2000 isn't playing. When playing, you should always get a result. |
stringlet tfo = fb.TitleFormat("%artist%");
console.log(tfo.Eval());EvalActivePlaylistItem(playlistItemIndex)Evaluates this title formatting expression for an item in the active playlist. Use this method to access playlist-specific fields such as %list_index%, %list_total% and %isplaying%.
| Name | Type | Description |
|---|---|---|
playlistItemIndex | number | Zero-based item index in the active playlist. |
stringError — If there is no active playlist or playlistItemIndex is invalid.
EvalPlaylistItem(playlistIndex, playlistItemIndex)Evaluates this title formatting expression for an item in a specific playlist. Use this method to access playlist-specific fields such as %list_index%, %list_total% and %isplaying%.
| Name | Type | Description |
|---|---|---|
playlistIndex | number | Zero-based playlist index. |
playlistItemIndex | number | Zero-based item index in the playlist. |
stringError — If playlistIndex or playlistItemIndex is invalid.
EvalWithMetadb(handle, want_full_info)| Name | Type | Description |
|---|---|---|
handle | FbMetadbHandle | |
want_full_info = falseoptional | boolean | This enables full retrieval of tags that have been blocked with [b][url=https://www.foobar2000.org/LargeFieldsConfig-v2]LargeFieldsConfig-v2[/url][/b] in the latest foobar2000 2.26 previews. |
stringlet tfo = fb.TitleFormat("%artist%");
console.log(tfo.EvalWithMetadb(fb.GetFocusItem()));EvalWithMetadbs(handle_list)| Name | Type | Description |
|---|---|---|
handle_list | FbMetadbHandleList |
Array<string>let tfo = fb.TitleFormat("%artist%");
let handle_list = fb.GetLibraryItems();
let artists = tfo.EvalWithMetadbs(handle_list);
console.log(handle_list.Count === artists.length); // should always be true!