getSelectedItems - Methods - Author API

Author API Methods


Retrieve the contents of the selected Items, including their Questions and Features, in the Item list view.

You would want to use this method so that you can display the Item JSON in your application for validation purposes, for example.

Important The enable_selection initialization option must be set to true for this method to function.


var selectedItemsPromise = authorApp.getSelectedItems();

    .then(function (response) {
        /* The response object will be similar to:
            data: {
                items: [
                        item: { ... },
                        questions: { ... },
                        features: { ... }
    .catch(function (error) {
        console.log('An error occurred');



Return value

Type object

The method returns a Promise which resolves with an array of Item JSON(s) (see itemJson) from the server. An asynchronous call is performed to retreive the selected Items and its related contents.

Type boolean

If no Items are selected or if this method is called while not in the Item list view, false is returned.

Type definitions

  • itemJson object

    • features array[widgetObject]

      Array of Widget objects for Features in the Item.

    • item object

      The settings and contents of the Item.

    • questions array[widgetObject]

      Array of Widget objects for Questions in the Item.

Related articles

  • The enable_selection initialization option, which allows authors to select multiple Items in the Item list view.
  • The clearSelectedItems() method, which deselects the Items in the Item list view.
Was this article helpful?

Did you arrive here by accident? If so, learn more about Learnosity.