Class: BaseObject

The base class of every object managed by the container (the Provider, Component, Module and Application classes extend it). Extend it for a plain object; its lifetime is @Transient: a new instance each time it is requested.

An object is never created with new: the container creates it (getObject(), buildObject(), the module options), asynchronously: its @Inject properties are resolved, its @Configurable properties get their configured values (validated and transformed by their schemas; a property not configured keeps its initializer, else the default of its schema), then its init() runs, then its startup() (the object is given to its requesters once started, except to the call chain of its startup). Once its application has launched, its launched() runs. At its teardown (dispose(), or the teardown of the object, scope or application which created it) its beforeDestroy() runs, then the objects it created are destroyed, then its destroy() runs. Each object owns a container: the objects it creates are destroyed with it.

Example

import {BaseObject, Container, DTO} from 'lakutata'
import {Configurable} from 'lakutata/decorator/di'

class Counter extends BaseObject {
    @Configurable(DTO.Number().integer().min(0))
    protected readonly start: number = 0

    #value: number = 0

    protected async init(): Promise<void> {
        this.#value = this.start
    }

    public increment(): number {
        return ++this.#value
    }
}

const container: Container = new Container()
const counter: Counter = await container.build(Counter, {start: 10})
console.log(counter.increment()) //11
await counter.dispose()

Extends

• AsyncConstructor

Extended by

• AccessControlRule
• Provider
• AccessControl

Constructors

Constructor

new BaseObject(cradleProxy): BaseObject

Called by the container only: an object is created through a container (see the class description), never with new.

Parameters

cradleProxy

Record<string | symbol, any>

The container's resolution proxy.

Returns

BaseObject

Overrides

AsyncConstructor.constructor

Properties

constructor

constructor: Function

The initial value of Object.prototype.constructor is the standard built-in Object constructor.

Inherited from

AsyncConstructor.constructor

Accessors

$id

Get Signature

get $id(): string | symbol

The name the object was registered under (its key in the module options), or a symbol of its class for an object registered by its class or built without registration.

Returns

string | symbol

---

$symbol

Get Signature

get $symbol(): symbol

A symbol unique to the instance (made from its $uuid), created on first read.

Returns

symbol

---

$uuid

Get Signature

get $uuid(): string

A random UUID identifying the instance.

Returns

string

---

className

Get Signature

get static className(): string

The name of the class.

Returns

string

---

className

Get Signature

get className(): string

The name of the object's class.

Returns

string

Methods

[asyncDispose]()

[asyncDispose](): Promise<void>

Dispose the object at the end of an await using block, as BaseObject.dispose.

Returns

Promise<void>

Resolves once the object is destroyed.

---

acceptsOption()

static acceptsOption(name, value): boolean

Whether the class accepts an option which is not one of its @Configurable properties (an option it reads with getConfigurableRecords()): the modules check the options of the objects they declare and warn of the options the classes do not accept. Override it in the classes reading options without configurable properties.

Parameters

name

string

The option name.

value

unknown

The option value.

Returns

boolean

true when the option is accepted; false by default.

---

assign()

Call Signature

static assign<T, U>(target, source): T & U

Copy the values of all of the enumerable own properties from one or more source objects to a target object. Returns the target object.

Type Parameters

T

T extends object

U

U

Parameters

target

T

The target object to copy to.

source

U

The source object from which to copy properties.

Returns

T & U

Inherited from

AsyncConstructor.assign

Call Signature

static assign<T, U, V>(target, source1, source2): T & U & V

Copy the values of all of the enumerable own properties from one or more source objects to a target object. Returns the target object.

Type Parameters

T

T extends object

U

U

V

V

Parameters

target

T

The target object to copy to.

source1

U

The first source object from which to copy properties.

source2

V

The second source object from which to copy properties.

Returns

T & U & V

Inherited from

AsyncConstructor.assign

Call Signature

static assign<T, U, V, W>(target, source1, source2, source3): T & U & V & W

Copy the values of all of the enumerable own properties from one or more source objects to a target object. Returns the target object.

Type Parameters

T

T extends object

U

U

V

V

W

W

Parameters

target

T

The target object to copy to.

source1

U

The first source object from which to copy properties.

source2

V

The second source object from which to copy properties.

source3

W

The third source object from which to copy properties.

Returns

T & U & V & W

Inherited from

AsyncConstructor.assign

Call Signature

static assign(target, ...sources): any

Copy the values of all of the enumerable own properties from one or more source objects to a target object. Returns the target object.

Parameters

target

object

The target object to copy to.

sources

...any[]

One or more source objects from which to copy properties

Returns

any

Inherited from

AsyncConstructor.assign

---

create()

Call Signature

static create(o): any

Creates an object that has the specified prototype or that has null prototype.

Parameters

o

object | null

Object to use as a prototype. May be null.

Returns

any

Inherited from

AsyncConstructor.create

Call Signature

static create(o, properties): any

Creates an object that has the specified prototype, and that optionally contains specified properties.

Parameters

o

object | null

Object to use as a prototype. May be null

properties

PropertyDescriptorMap & ThisType<any>

JavaScript object that contains one or more property descriptors.

Returns

any

Inherited from

AsyncConstructor.create

---

defineProperties()

static defineProperties<T>(o, properties): T

Adds one or more properties to an object, and/or modifies attributes of existing properties.

Type Parameters

T

T

Parameters

o

T

Object on which to add or modify the properties. This can be a native JavaScript object or a DOM object.

properties

PropertyDescriptorMap & ThisType<any>

JavaScript object that contains one or more descriptor objects. Each descriptor object describes a data property or an accessor property.

Returns

T

Inherited from

AsyncConstructor.defineProperties

---

defineProperty()

static defineProperty<T>(o, p, attributes): T

Adds a property to an object, or modifies attributes of an existing property.

Type Parameters

T

T

Parameters

o

T

Object on which to add or modify the property. This can be a native JavaScript object (that is, a user-defined object or a built in object) or a DOM object.

p

PropertyKey

The property name.

attributes

PropertyDescriptor & ThisType<any>

Descriptor for the property. It can be for a data property or an accessor property.

Returns

T

Inherited from

AsyncConstructor.defineProperty

---

dispose()

dispose(): Promise<void>

Destroy the object: its beforeDestroy(), the objects it created, then its destroy(). Calling it more than once destroys once. A disposed singleton or scoped object is dropped from its container, which creates a new one on the next request. Using a destroyed object (getObject(), buildObject()) throws an ObjectDestroyedException.

Returns

Promise<void>

Resolves once the object is destroyed.

Throws

The error of the object's own beforeDestroy() or destroy() (an AggregateError when several fail); the errors of the objects it created are reported through the application's logger instead.

---

entries()

Call Signature

static entries<T>(o): [string, T][]

Returns an array of key/values of the enumerable own properties of an object

Type Parameters

T

T

Parameters

o

{[s: string]: T; } | ArrayLike<T>

Object that contains the properties and methods. This can be an object that you created or an existing Document Object Model (DOM) object.

Returns

[string, T][]

Inherited from

AsyncConstructor.entries

Call Signature

static entries(o): [string, any][]

Returns an array of key/values of the enumerable own properties of an object

Parameters

o

{ }

Object that contains the properties and methods. This can be an object that you created or an existing Document Object Model (DOM) object.

Returns

[string, any][]

Inherited from

AsyncConstructor.entries

---

freeze()

Call Signature

static freeze<T>(f): T

Prevents the modification of existing property attributes and values, and prevents the addition of new properties.

Type Parameters

T

T extends Function

Parameters

f

T

Object on which to lock the attributes.

Returns

T

Inherited from

AsyncConstructor.freeze

Call Signature

static freeze<T, U>(o): Readonly<T>

Prevents the modification of existing property attributes and values, and prevents the addition of new properties.

Type Parameters

T

T extends object

U

U extends string | number | bigint | boolean | symbol

Parameters

o

T

Object on which to lock the attributes.

Returns

Readonly<T>

Inherited from

AsyncConstructor.freeze

Call Signature

static freeze<T>(o): Readonly<T>

Prevents the modification of existing property attributes and values, and prevents the addition of new properties.

Type Parameters

T

T

Parameters

o

T

Object on which to lock the attributes.

Returns

Readonly<T>

Inherited from

AsyncConstructor.freeze

---

fromEntries()

Call Signature

static fromEntries<T>(entries): object

Returns an object created by key-value entries for properties and methods

Type Parameters

T

T = any

Parameters

entries

Iterable<readonly [PropertyKey, T]>

An iterable object that contains key-value entries for properties and methods.

Returns

object

Inherited from

AsyncConstructor.fromEntries

Call Signature

static fromEntries(entries): any

Returns an object created by key-value entries for properties and methods

Parameters

entries

Iterable<readonly any[]>

An iterable object that contains key-value entries for properties and methods.

Returns

any

Inherited from

AsyncConstructor.fromEntries

---

getMethod()

getMethod(name, throwExceptionIfNotFound?): (...args) => any

Get a method bound to the object, to call it by name.

Parameters

name

string | symbol

The method name or symbol.

throwExceptionIfNotFound?

boolean

Throw when the method does not exist, instead of returning a function doing nothing; false by default.

Returns

The bound method, or a function doing nothing (returning undefined) when it does not exist.

(...args) => any

Throws

When the method does not exist and throwExceptionIfNotFound is true.

---

getOwnPropertyDescriptor()

static getOwnPropertyDescriptor(o, p): PropertyDescriptor | undefined

Gets the own property descriptor of the specified object. An own property descriptor is one that is defined directly on the object and is not inherited from the object's prototype.

Parameters

o

any

Object that contains the property.

p

PropertyKey

Name of the property.

Returns

PropertyDescriptor | undefined

Inherited from

AsyncConstructor.getOwnPropertyDescriptor

---

getOwnPropertyDescriptors()

static getOwnPropertyDescriptors<T>(o): { [P in string | number | symbol]: TypedPropertyDescriptor<T[P]> } & object

Returns an object containing all own property descriptors of an object

Type Parameters

T

T

Parameters

o

T

Object that contains the properties and methods. This can be an object that you created or an existing Document Object Model (DOM) object.

Returns

{ [P in string | number | symbol]: TypedPropertyDescriptor<T[P]> } & object

Inherited from

AsyncConstructor.getOwnPropertyDescriptors

---

getOwnPropertyNames()

static getOwnPropertyNames(o): string[]

Returns the names of the own properties of an object. The own properties of an object are those that are defined directly on that object, and are not inherited from the object's prototype. The properties of an object include both fields (objects) and functions.

Parameters

o

any

Object that contains the own properties.

Returns

string[]

Inherited from

AsyncConstructor.getOwnPropertyNames

---

getOwnPropertySymbols()

static getOwnPropertySymbols(o): symbol[]

Returns an array of all symbol properties found directly on object o.

Parameters

o

any

Object to retrieve the symbols from.

Returns

symbol[]

Inherited from

AsyncConstructor.getOwnPropertySymbols

---

getProperty()

getProperty<T>(propertyKey, defaultValue?): T

Read an own property of the object.

Type Parameters

T

T = any

Parameters

propertyKey

string

The property name.

defaultValue?

T

The value returned when the object has no own property of this name.

Returns

T

The property value, or the default value.

---

getPrototypeOf()

static getPrototypeOf(o): any

Returns the prototype of an object.

Parameters

o

any

The object that references the prototype.

Returns

any

Inherited from

AsyncConstructor.getPrototypeOf

---

hasMethod()

hasMethod(name): boolean

Whether the object has a method of this name or symbol (a function of its class, not an own property).

Parameters

name

string | symbol

The method name or symbol.

Returns

boolean

true when the method exists.

---

hasOwn()

static hasOwn(o, v): boolean

Determines whether an object has a property with the specified name.

Parameters

o

object

An object.

v

PropertyKey

A property name.

Returns

boolean

Inherited from

AsyncConstructor.hasOwn

---

hasOwnProperty()

hasOwnProperty(v): boolean

Determines whether an object has a property with the specified name.

Parameters

v

PropertyKey

A property name.

Returns

boolean

Inherited from

AsyncConstructor.hasOwnProperty

---

hasProperty()

hasProperty(propertyKey): boolean

Whether the object has an own property (not a method or accessor of its class) of this name or symbol.

Parameters

propertyKey

string | symbol

The property name or symbol.

Returns

boolean

true when the property exists.

---

is()

static is(value1, value2): boolean

Returns true if the values are the same value, false otherwise.

Parameters

value1

any

The first value.

value2

any

The second value.

Returns

boolean

Inherited from

AsyncConstructor.is

---

isExtensible()

static isExtensible(o): boolean

Returns a value that indicates whether new properties can be added to an object.

Parameters

o

any

Object to test.

Returns

boolean

Inherited from

AsyncConstructor.isExtensible

---

isFrozen()

static isFrozen(o): boolean

Returns true if existing property attributes and values cannot be modified in an object, and new properties cannot be added to the object.

Parameters

o

any

Object to test.

Returns

boolean

Inherited from

AsyncConstructor.isFrozen

---

isPrototypeOf()

isPrototypeOf(v): boolean

Determines whether an object exists in another object's prototype chain.

Parameters

v

Object

Another object whose prototype chain is to be checked.

Returns

boolean

Inherited from

AsyncConstructor.isPrototypeOf

---

isSealed()

static isSealed(o): boolean

Returns true if existing property attributes cannot be modified in an object and new properties cannot be added to the object.

Parameters

o

any

Object to test.

Returns

boolean

Inherited from

AsyncConstructor.isSealed

---

keys()

Call Signature

static keys(o): string[]

Returns the names of the enumerable string properties and methods of an object.

Parameters

o

object

Object that contains the properties and methods. This can be an object that you created or an existing Document Object Model (DOM) object.

Returns

string[]

Inherited from

AsyncConstructor.keys

Call Signature

static keys(o): string[]

Returns the names of the enumerable string properties and methods of an object.

Parameters

o

{ }

Object that contains the properties and methods. This can be an object that you created or an existing Document Object Model (DOM) object.

Returns

string[]

Inherited from

AsyncConstructor.keys

---

preventExtensions()

static preventExtensions<T>(o): T

Prevents the addition of new properties to an object.

Type Parameters

T

T

Parameters

o

T

Object to make non-extensible.

Returns

T

Inherited from

AsyncConstructor.preventExtensions

---

propertyIsEnumerable()

propertyIsEnumerable(v): boolean

Determines whether a specified property is enumerable.

Parameters

v

PropertyKey

A property name.

Returns

boolean

Inherited from

AsyncConstructor.propertyIsEnumerable

---

propertyNames()

propertyNames(): string[]

The names of the object's own properties (not its class's methods and accessors).

Returns

string[]

The names.

---

propertySymbols()

propertySymbols(): symbol[]

The symbols of the object's own properties.

Returns

symbol[]

The symbols.

---

seal()

static seal<T>(o): T

Prevents the modification of attributes of existing properties, and prevents the addition of new properties.

Type Parameters

T

T

Parameters

o

T

Object on which to lock the attributes.

Returns

T

Inherited from

AsyncConstructor.seal

---

setProperty()

setProperty(propertyKey, value): void

Set a property of the object; the value is not validated, even for a @Configurable property.

Parameters

propertyKey

string

The property name.

value

any

The value.

Returns

void

---

setPrototypeOf()

static setPrototypeOf(o, proto): any

Sets the prototype of a specified object o to object proto or null. Returns the object o.

Parameters

o

any

The object to change its prototype.

proto

object | null

The value of the new prototype or null.

Returns

any

Inherited from

AsyncConstructor.setPrototypeOf

---

toLocaleString()

toLocaleString(): string

Returns a date converted to a string using the current locale.

Returns

string

Inherited from

AsyncConstructor.toLocaleString

---

toString()

toString(): string

Returns a string representation of an object.

Returns

string

Inherited from

AsyncConstructor.toString

---

valueOf()

valueOf(): Object

Returns the primitive value of the specified object.

Returns

Object

Inherited from

AsyncConstructor.valueOf

---

values()

Call Signature

static values<T>(o): T[]

Returns an array of values of the enumerable own properties of an object

Type Parameters

T

T

Parameters

o

{[s: string]: T; } | ArrayLike<T>

Object that contains the properties and methods. This can be an object that you created or an existing Document Object Model (DOM) object.

Returns

T[]

Inherited from

AsyncConstructor.values

Call Signature

static values(o): any[]

Returns an array of values of the enumerable own properties of an object

Parameters

o

{ }

Object that contains the properties and methods. This can be an object that you created or an existing Document Object Model (DOM) object.

Returns

any[]

Inherited from

AsyncConstructor.values