kids-db v5.0.1
DB
const { DB } = require(`kids-db`);
Constructor
Инициализация новой инстанции
const db = new DB(DB_Name, options); // => this
Параметр | Тип | Описание |
---|---|---|
options | Object | Опции |
Options
Общие опции
Опция | Тип | Описание | По умолчанию |
---|---|---|---|
ttl | number | Время жизни элементов в оперативной памяти в секундах | 180 |
static | boolean | Будут ли элементы автоматически очищаться из оперативной памяти | false |
mode | string | Режим работы БД | JSON |
Например
new DB(`users`, {
ttl: 300,
mode: `BSON`,
});
init
Инициализирует БД
db.init(); // => Promise<true>
statistics
Возвращает текущую статистику для БД
db.statistics(); // => Promise<Object>
Параметр | Тип | Описание |
---|---|---|
name | string | Название БД |
path | string | Путь к БД |
elements | number | Количество элементов в БД |
elements_in_mem | number | Количество элементов в оперативной памяти |
ttl | number | Время жизни элемента в оперативной памяти в секундах |
last_access | number | Время последнего обращения к БД в миллисекундах, прошедших с 1 января 1970 года |
last_change | number | Время последнего изменения в БД в миллисекундах, прошедших с 1 января 1970 года |
created | number | Время создания БД в миллисекундах, прошедших с 1 января 1970 года |
save_all_elements_in_mem
Сохраняет все элементы из оперативной памяти, в постоянную память
db.save_all_elements_in_mem(); // => Promise<true>
set_ttl
Сохраняет все элементы из оперативной памяти, в постоянную память
db.set_ttl(ttl); // => Promise<true>
Параметр | Тип | Описание |
---|---|---|
ttl | number | Время жизни элемента в оперативной памяти в секундах |
elements
Возвращает обьект с функциями для взаимодействия с элементами БД
db.elements; // => Promise<Object>
Параметр | Тип | Описание |
---|---|---|
get | function | Функция получения элемента |
create | function | Функция создания элемента |
update | function | Функция обновления элемента |
save | function | Функция сохранения элемента |
delete | function | Функция удаления элемента |
get
Возвращает выбранный элемент
db.elements.get(element_id, options); // => Promise<Object>
Параметр | Тип | Описание |
---|---|---|
element_id | string | Идентификатор элемента |
options | Object | Опции |
create
Создает новый элемент
db.elements.create(element_id, data, options); // => Promise<Object>
Параметр | Тип | Описание |
---|---|---|
element_id | string | Идентификатор элемента |
data | object | Данные элемента |
options | Object | Опции |
update
Обновляет выбранный элемент
db.elements.update(element_id, data, options); // => Promise<Object>
Параметр | Тип | Описание |
---|---|---|
element_id | string | Идентификатор элемента |
data | object | Данные элемента |
options | Object | Опции |
save
Сохраняет выбранный элемент
db.elements.save(element_id); // => Promise<true>
Параметр | Тип | Описание |
---|---|---|
element_id | string | Идентификатор элемента |
delete
Удаляет выбранный элемент
db.elements.delete(element_id); // => Promise<true>
Параметр | Тип | Описание |
---|---|---|
element_id | string | Идентификатор элемента |
exists
Проверяет существование элемента
db.elements.exists(element_id); // => Promise<boolean>
Параметр | Тип | Описание |
---|---|---|
element_id | string | Идентификатор элемента |
list
Выводит массив в котором содержатся все идентификаторы существующих элементов
db.elements.list(); // => Promise<Array>
extended_list
Выводит массив в котором содержатся все идентификаторы существующих элементов и дополнительная информация о них
db.elements.extended_list(); // => Promise<Array>
get_selected
Возвращает массив с выбранными элементами
db.elements.get_selected(element_id); // => Promise<Array>
Параметр | Тип | Описание |
---|---|---|
elements_ids | array | Массив с идентификаторами элементов которые нужно получить |
get_all
Возвращает массив со всеми существующими элементами
db.elements.get_all(); // => Promise<Array>
File
load
Инициализация новой инстанции с выбранным элементом
const file = db.load(id, options); // => Promise<this>
//OR
const file = db.create(id, file_data, options); // => Promise<this>
Параметр | Тип | Описание |
---|---|---|
id | string | Идентификатор файла, который нужно получить |
options | Object | Опции |
data
Получает данные которые содержатся в выбранном элементе
file.data(); // => Promise<Object>
save
Сохраняет выбранный элемент в постоянную память
file.save(); // => Promise<true>
update
Обновляет выбранный элемент
file.update(new_data); // => Promise<Object>
Параметр | Тип | Описание |
---|---|---|
new_data | object | Новые данные, которые должны содержаться в выбранном элементе |
delete
Навсегда удаляет выбранный элемент с оперативной и постоянной памяти
file.delete(); // => Promise<true>
File_Options
Общие опции
Опция | Тип | Описание | По умолчанию |
---|---|---|---|
ttl | number | Время жизни элемента в оперативной памяти в секундах | Опции |
static | boolean | Будет ли элемент автоматически очищаться из оперативной памяти | Опции |
settings
const { setting } = require(`kids-db`);
set_database_dir
Изменяет папку в которой будут храниться данные
settings.set_database_dir(new_dir); // => Promise<true>
Параметр | Тип | Описание |
---|---|---|
new_dir | string | Название папки в которой будут храниться все данные |
set_database_dir
Изменяет путь в котором будет храниться папка с данными
settings.set_database_path(new_path); // => Promise<true>
Параметр | Тип | Описание |
---|---|---|
new_path | string | Путь к папке в которой хранятся все данные |
set_database_dir
Изменяет путь в котором будет храниться папка с данными
settings.set_full_path(new_path); // => Promise<true>
Параметр | Тип | Описание |
---|---|---|
new_path | string | Полный путь к папке в которой хранятся все данные |
enable_autoclear_cache
Включает автоматическую очистку элементов из оперативной
settings.enable_autoclear_cache(); // => Promise<true>
disable_autoclear_cache
Отключает автоматическую очистку элементов из оперативной
settings.disable_autoclear_cache(); // => Promise<true>