Selects matched objects. The parameter
objects must be an array of strings or an array of objects.
If a String is provided, the objects that match the provided IDs will be selected.
If an array of objects is passed, these objects should have the following structure:
Note that the promise does not resolve to an array of selected objects. Use onObjectSelected for that.