getActions() method from fcf.ActionsQueue class

Class: fcf.ActionsQueue

Package: fcf-framework-core

File: fcf.js

Available from version: 2.0.16

The getActions method returns an fcf.Actions object that manages the current task queue. It ensures sequential execution of tasks by chaining new actions to the completion of all previously scheduled operations in the queue and automatically triggers the execution of accumulated completion callbacks.

The getActions() method is a key tool for managing the flow of asynchronous operations within a single fcf.ActionsQueue. Its primary purpose is to provide an interface for adding new tasks to a chain, guaranteeing their strict sequence relative to existing tasks.

• Chain Linking: If there is an active task in the queue, the new fcf.Actions object returned by the method is automatically attached to the completion (finally) of the previous task. This allows for building long, sequential chains of asynchronous calls.
• Completion Management: The method checks for accumulated callbacks that were scheduled to run immediately upon the conclusion of previous operations. If such callbacks exist, they are executed before control is passed to the new chain.
• Initialization: If the queue is empty, the method creates a new, independent action chain.

The method itself does not throw exceptions; however, the returned fcf.Actions object may contain errors encountered during the execution of tasks in the queue. To handle these errors, use the catch() method on the returned object.