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:
- 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, searchParamsopt) → {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
|
|
|
searchParams |
Object
|
<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
-
?