Documentation doesn't explain record states

[seanrucker]

I can see that records have these four properties:

• isPending
• isRejected
• isRequested
• isResolved

I gather that when isResolved = true the record.content property is fulfilled and I can render my template. I'm guessing that isRejected is true if the load failed. What is the difference between isPending and isRequested?

Probably all four should be explained in the documentation with some sort of sample template logic. Example:

{{#if record.isResolved}}
    {{#with record.content as |model|}}
        <div>{{model.name}}</div>
    {{/with}}
{{else if record.isRejected}}
    <div class="error">Error</div>
{{else}}
    <div class="loading">Loading...</div>
{{/if}}

[flexyford]

https://github.com/flexyford/impagination/blob/master/src/page.js#L10

isPending - when we wait on the fetch to return
isResolved - when the fetch is resolved
isRejected - when the fetch is rejected
isRequested - record isPending OR isResolved OR isRejected

isRequested is false whenever we initialize our dataset with unrequested pages.

fetch: function(pageOffset, pageSize, stats) {
    let params = {
      page: pageOffset,
    };
    return this.store.query('record', params).then((data) => {
      // Initialize the dataset with Unrequested Pages of Unrequested Records all the way up to stats.totalPages 
      stats.totalPages = data.get('totalPages'); 
      return data.get('records');
    });
},

This is a record attribute we inherit from impagination and should be explained in the README. Leaving this issue open for now as a result.