Похоже, вы наткнулись на одну из самых интересных вещей в Javascript: функции обратного вызова! К сожалению, как вы обнаружили, фактическое возвращаемое значение api.rooms.getRooms().done (или, на самом деле, .done().fail) не так полезно. Вероятно, вы имели в виду:

$(document).ready(function() {
    api.rooms.getRooms().done(function(data) {
        var rooms = JSON.stringify(data);
        console.info(rooms);
        $("#title").text(rooms); // <<< sets the DOM element <<<
    }).fail(function(jqXHR, textStatus, errorThrown) {
        console.info("Request failed: jqXHR.status = " + jqXHR.status + ",                 
       textStatus = " + textStatus + ", errorThrown = " + errorThrown);
    });
});

Что происходит

Когда api.getRooms().done() вернется, скорее всего, он еще не сделал сетевой запрос! Он договорился, что вызовет эту функцию, если данные вернутся успешно:

function(data) {
    var rooms = JSON.stringify(data);
    console.info(rooms);
    $("#title").text(rooms); // <<< sets the DOM element <<<
}

Это очень распространенный стиль в JS. Сетевые запросы занимают много времени, и мы можем захотеть заняться другими делами, пока ждем завершения запроса. Решение состоит в том, чтобы передать function(data), который сообщит JS, что делать, когда data будет готов. Фактическое значение, возвращаемое этими функциями, не используется и не имеет значения.

Это часть асинхронного программирования: вместо использования return rooms; в конце функции callback мы вызываем другую функцию, например $("#title").text(rooms);, чтобы действительно что-то сделать после того, как данные вернутся.

Углубляясь

Для получения дополнительных примеров стиля передачи продолжения (который я использовал здесь), а также информации об аду обратных вызовов и способах его избежать, эти статьи могут указать вам новые направления для продвижения вашего обучения:

• Понимание обратных вызовов JavaScript
• Обратные вызовы против обещаний против RxJS против async / await

¹ Единственное место, где используется возвращаемое значение, - это удобное место для зависания вызовов .done() и .fail(). Это [object Object], который вы видите. После того, как вы назначили обратные вызовы done и fail, вам больше никогда не понадобится этот объект.

Теоретически этот объект не является важной частью стиля передачи продолжения, и не каждая библиотека работает таким образом. Он просто позволяет связать вызовы .done() и .fail() (которые также возвращают этот объект для объединения) и делает ваш код красивым. Дизайнер также мог бы сделать аргументы обратного вызова done и fail для запроса, что алгебраически проще, но труднее читать на практике:

api.rooms.getRooms(function done(data) {...}, function fail(...) {...})

Вам нужно указать, какое свойство объекта вы хотите распечатать. Stringify преобразует содержимое объекта в строку. Итак, если вы хотите, чтобы ваш титул был собственностью, сделайте что-нибудь вроде.

$('#my_h3').text( data.title );

Результат

api.rooms.getRooms().done(function(data) {
    console.info(JSON.stringify(data));
}).fail(function(jqXHR, textStatus, errorThrown) {
    console.info("Request failed: jqXHR.status = " + jqXHR.status + ",                 
   textStatus = " + textStatus + ", errorThrown = " + errorThrown);
})

это jQuery объект

Итак, ваш код эквивалентен

$("#title").text({})

Любой объект здесь приведет к тому, что содержимое #title будет [object Object].

Асинхронность не может быть сокращена ... вам нужно сделать что-то вроде

$(document).ready(function() {
    api.rooms.getRooms().done(function(data) {
        $("#title").text(JSON.stringify(data));
    }).fail(function(jqXHR, textStatus, errorThrown) {
        console.info("Request failed: jqXHR.status = " + jqXHR.status + ",                 
       textStatus = " + textStatus + ", errorThrown = " + errorThrown);
    }))
});

вместо