Class: BackendScriptApi

BackendScriptApi

Members

currentNote

Properties:
Name Type Description
note Note where script is currently executing. Don't mix this up with concept of active note
Source:

originEntity

Properties:
Name Type Description
entity Entity whose event triggered this executions
Source:

startNote

Properties:
Name Type Description
note Note where script started executing
Source:

Methods

createDataNote(parentNoteId, title, content) → {Object}

Create data note - data in this context means object serializable to JSON. Created note will be of type 'code' and JSON MIME type. See also createNewNote() for more options.
Parameters:
Name Type Description
parentNoteId string
title string
content object
Source:
Returns:
Type
Object

createNewNote(paramsopt) → {Object}

Parameters:
Name Type Attributes Description
params CreateNewNoteParams <optional>
Source:
Returns:
object contains newly created entities note and branch
Type
Object

createNote(parentNoteId, title, contentopt, extraOptionsopt) → {Object}

Parameters:
Name Type Attributes Default Description
parentNoteId string create new note under this parent
title string
content string <optional>
""
extraOptions CreateNoteExtraOptions <optional>
{}
Deprecated:
  • please use createTextNote() with similar API for simpler use cases or createNewNote() for more complex needs
Source:
Returns:
object contains newly created entities note and branch
Type
Object

createTextNote(parentNoteId, title, content) → {Object}

Create text note. See also createNewNote() for more options.
Parameters:
Name Type Description
parentNoteId string
title string
content string
Source:
Returns:
Type
Object

ensureNoteIsAbsentFromParent(noteId, parentNoteId) → {void}

If there's a branch between note and parent note, remove it. Otherwise do nothing.
Parameters:
Name Type Description
noteId string
parentNoteId string
Source:
Returns:
Type
void

ensureNoteIsPresentInParent(noteId, parentNoteId, prefix) → {void}

If there's no branch between note and parent note, create one. Otherwise do nothing.
Parameters:
Name Type Description
noteId string
parentNoteId string
prefix string if branch will be create between note and parent note, set this prefix
Source:
Returns:
Type
void

getAppInfo() → {Object|*}

Source:
Returns:
- object representing basic info about running Trilium version
Type
Object | *

getAttribute(attributeId) → {Attribute|null}

Parameters:
Name Type Description
attributeId string
Source:
Returns:
Type
Attribute | null

getBranch(branchId) → {Branch|null}

Parameters:
Name Type Description
branchId string
Source:
Returns:
Type
Branch | null

getDateNote(date) → {Note|null}

Returns day note for given date. If such note doesn't exist, it is created.
Parameters:
Name Type Description
date string in YYYY-MM-DD format
Source:
Returns:
Type
Note | null

getEntities(SQL, array) → {Array.<Entity>}

Parameters:
Name Type Description
SQL string query
array Array.<?> of params
Source:
Returns:
Type
Array.<Entity>

getEntity(SQL, array) → {Entity|null}

Retrieves first entity from the SQL's result set.
Parameters:
Name Type Description
SQL string query
array Array.<?> of params
Source:
Returns:
Type
Entity | null

getInstanceName() → {string|null}

Instance name identifies particular Trilium instance. It can be useful for scripts if some action needs to happen on only one specific instance.
Source:
Returns:
Type
string | null

getMonthNote(date) → {Note|null}

Returns month note for given date. If such note doesn't exist, it is created.
Parameters:
Name Type Description
date string in YYYY-MM format
Source:
Returns:
Type
Note | null

getNote(noteId) → {Note|null}

Parameters:
Name Type Description
noteId string
Source:
Returns:
Type
Note | null

getNotesWithLabel(name, valueopt) → {Array.<Note>}

Retrieves notes with given label name & value
Parameters:
Name Type Attributes Description
name string attribute name
value string <optional>
attribute value
Source:
Returns:
Type
Array.<Note>

getNoteWithLabel(name, valueopt) → {Note|null}

Retrieves first note with given label name & value
Parameters:
Name Type Attributes Description
name string attribute name
value string <optional>
attribute value
Source:
Returns:
Type
Note | null

getRootCalendarNote() → {Note|null}

Returns root note of the calendar.
Source:
Returns:
Type
Note | null

getTodayNote() → {Note|null}

Returns today's day note. If such note doesn't exist, it is created.
Source:
Returns:
Type
Note | null

getWeekNote(date, options) → {Note|null}

Returns note for the first date of the week of the given date.
Parameters:
Name Type Description
date string in YYYY-MM-DD format
options object "startOfTheWeek" - either "monday" (default) or "sunday"
Source:
Returns:
Type
Note | null

getYearNote(year) → {Note|null}

Returns year note for given year. If such note doesn't exist, it is created.
Parameters:
Name Type Description
year string in YYYY format
Source:
Returns:
Type
Note | null

log(message)

Log given message to trilium logs.
Parameters:
Name Type Description
message
Source:

refreshTree()

Deprecated:
  • - this is now no-op since all the changes should be gracefully handled per widget
Source:

searchForNote(searchString) → {Note|null}

This is a powerful search method - you can search by attributes and their values, e.g.: "#dateModified =* MONTH AND #log". See full documentation for all options at: https://github.com/zadam/trilium/wiki/Search
Parameters:
Name Type Description
searchString string
Source:
Returns:
Type
Note | null

searchForNotes(query, searchContextopt) → {Array.<Note>}

This is a powerful search method - you can search by attributes and their values, e.g.: "#dateModified =* MONTH AND #log". See full documentation for all options at: https://github.com/zadam/trilium/wiki/Search
Parameters:
Name Type Attributes Description
query string
searchContext SearchContext <optional>
Source:
Returns:
Type
Array.<Note>

setNoteToParent(noteId, prefix, parentNoteId)

This method finds note by its noteId and prefix and either sets it to the given parentNoteId or removes the branch (if parentNoteId is not given). This method looks similar to toggleNoteInParent() but differs because we're looking up branch by prefix.
Parameters:
Name Type Description
noteId string
prefix string
parentNoteId string | null
Deprecated:
  • - this method is pretty confusing and serves specialized purpose only
Source:

sortNotesAlphabetically(parentNoteId)

Parameters:
Name Type Description
parentNoteId string this note's child notes will be sorted
Source:

toggleNoteInParent(present, noteId, parentNoteId, prefix) → {void}

Based on the value, either create or remove branch between note and parent note.
Parameters:
Name Type Description
present boolean true if we want the branch to exist, false if we want it gone
noteId string
parentNoteId string
prefix string if branch will be create between note and parent note, set this prefix
Source:
Returns:
Type
void

transactional(func) → {?}

This functions wraps code which is supposed to be running in transaction. If transaction already exists, then we'll use that transaction.
Parameters:
Name Type Description
func function
Source:
Returns:
result of func callback
Type
?