FbTitleFormat

class

js/foo_uie_jsplitter.js:3985

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.

Parameters

Name	Type	Description
`expression`	`string`

method

Eval

js/foo_uie_jsplitter.js:3994

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.

Parameters

Name	Type	Description
`force = false`optional	`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.

Returns

string

Example

let tfo = fb.TitleFormat("%artist%");
console.log(tfo.Eval());

method

EvalWithMetadb

js/foo_uie_jsplitter.js:4009

EvalWithMetadb(handle, want_full_info)

Parameters

Name	Type	Description
`handle`	`FbMetadbHandle`
`want_full_info = false`optional	`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.

Returns

string

Example

let tfo = fb.TitleFormat("%artist%");
console.log(tfo.EvalWithMetadb(fb.GetFocusItem()));

method

EvalWithMetadbs

js/foo_uie_jsplitter.js:4020

EvalWithMetadbs(handle_list)

Parameters

Name	Type	Description
`handle_list`	`FbMetadbHandleList`

Returns

Array<string>

Example

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!