(String) syncMethod - either 'basic' or 'webdav'. If unspecified, will

try to do webdav sync and failover to basic sync if rfc 6578 is not

supported by the server.

(String) timezone - VTIMEZONE calendar object.

(dav.Transport) xhr - request sender.

dav.syncCaldavAccount(account, options)

Fetch changes from the remote server to the account's calendars. Returns a Promise which will be fulfilled with an updated dav.Account object once sync is complete.

@param {dav.Account} account the calendar account to sync.

Options:

(dav.Sandbox) sandbox - optional request sandbox.

(dav.Transport) xhr - request sender.

contacts

dav.createCard(addressBook, options)

Create a vcard object on the parameter address book. Returns a Promise which will be fulfilled when the vcard has been created.

@param {dav.AddressBook} addressBook the address book to put the object on.

Options:

(String) data - VCARD object.

(String) filename - name for the vcard vcf file.

(dav.Sandbox) sandbox - optional request sandbox.

(dav.Transport) xhr - request sender.

dav.updateCard(card, options)

Persist updates to the parameter vcard object to the server. Returns a Promise which will be fulfilled when the vcard has been updated.

@param {dav.VCard} card updated vcard object.

Options:

(dav.Sandbox) sandbox - optional request sandbox.

(dav.Transport) xhr - request sender.

dav.deleteCard(card, options)

Delete the parameter vcard object on the server. Returns a Promise which will be fulfilled when the vcard has been deleted.

@param {dav.VCard} card target vcard object.

Options:

(dav.Sandbox) sandbox - optional request sandbox.

(dav.Transport) xhr - request sender.

dav.syncAddressBook(addressBook, options)

Fetch changes from the remote server to the parameter address books. Returns a Promise which will be fulfilled with an updated dav.AddressBook object once sync is complete.

@param {dav.AddressBook} addressBook the address book to fetch changes for.

Options:

(dav.Sandbox) sandbox - optional request sandbox.

(String) syncMethod - either 'basic' or 'webdav'. If unspecified, will

try to do webdav sync and failover to basic sync if rfc 6578 is not

supported by the server.

(dav.Transport) xhr - request sender.

dav.syncCarddavAccount(account, options)

Fetch changes from the remote server to the account's address books. Returns a Promise which will be fulfilled with an updated dav.Account object once sync is complete.

@param {dav.Account} account the address book account to sync.

Options:

(dav.Sandbox) sandbox - optional request sandbox.

(dav.Transport) xhr - request sender.

sandbox

dav.Sandbox()

Create a request sandbox. There is also a deprecated interface
dav.createSandbox(). Add requests to the sandbox like so:

var sandbox =newdav.Sandbox();

// sandbox instanceof Sandbox

dav.createAccount({

username:'Yoshi',

password:'babybowsersoscaryomg',

server:'https://caldav.yoshisstory.com',

sandbox: sandbox // <- Insert sandbox here!

})

.then(function(calendars){

// etc, etc.

});

And abort sandboxed requests as a group with sandbox.abort().

transport

dav.transport.Basic(credentials)

Create a new dav.transport.Basic object. This sends dav requests using http basic authentication.

@param {dav.Credentials} credentials user authorization.

dav.transport.Basic.send(request, options)

@param {dav.Request} request object with request info.

@return {Promise} a promise that will be resolved with an xhr request after its readyState is 4 or the result of applying an optional request `transformResponse` function to the xhr object after its readyState is 4.

dav.transport.OAuth2(credentials)

dav.transport.OAuth2.send(request, options)

@param {dav.Request} request object with request info.

@return {Promise} a promise that will be resolved with an xhr request after its readyState is 4 or the result of applying an optional request `transformResponse` function to the xhr object after its readyState is 4.

Options:

(dav.Sandbox) sandbox - optional request sandbox.

request

dav.request.addressBookQuery(options)

Options:

(String) depth - optional value for Depth header.

(Array.<Object>) props - list of props to request.

dav.request.basic(options)

Options:

(String) data - put request body.

(String) method - http method.

(String) etag - cached calendar object etag.

dav.request.calendarQuery(options)

Options:

(String) depth - optional value for Depth header.

(Array.<Object>) filters - list of filters to send with request.

(Array.<Object>) props - list of props to request.

(String) timezone - VTIMEZONE calendar object.

dav.request.propfind(options)

Options:

(String) depth - optional value for Depth header.

(Array.<Object>) props - list of props to request.

dav.request.syncCollection(options)

Options:

(String) depth - option value for Depth header.

(Array.<Object>) props - list of props to request.

(Number) syncLevel - indicates scope of the sync report request.

(String) syncToken - synchronization token provided by the server.

Client

dav.Client(xhr, options)

Create a new dav.Client object. The client interface allows consumers to set their credentials and transport once and then make authorized requests without passing them to each request. Each of the other, public API methods should be available on dav.Client objects.

@param {dav.Transport} xhr - request sender.

Options:

(String) baseUrl - root url to resolve relative request urls with.

dav.Client.send(req, options)

Send a request using this client's transport (and perhaps baseUrl).

@param {dav.request.Request} req - dav request.

@return {Promise} a promise that will be resolved with an xhr request after its readyState is 4 or the result of applying an optional request `transformResponse` function to the xhr object after its readyState is 4.

Options:

(dav.Sandbox) sandbox - optional request sandbox.

(String) url - relative url for request.

etc

dav.ns

Object that holds various xml namespace constants.

Example Usage

var dav =require('dav');

var xhr =newdav.transport.Basic(

newdav.Credentials({

username:'xxx',

password:'xxx'

})

);

dav.createAccount({ server:'http://dav.example.com', xhr: xhr })

.then(function(account){

// account instanceof dav.Account

account.calendars.forEach(function(calendar){

console.log('Found calendar named '+calendar.displayName);

// etc.

});

});

// Or, using the dav.Client interface:

var client =newdav.Client(xhr);

// No transport arg

client.createAccount({

server:'http://dav.example.com',

accountType:'carddav'

})

.then(function(account){

account.addressBooks.forEach(function(addressBook){

console.log('Found address book name '+addressBook.displayName);

// etc.

});

});

Using the lower-level webdav request api

Caution: The lower-level request api is undergoing some major reworking with frequent changes which will break consumers upgrading from earlier versions. If you're looking for a stable api and can live with the higher-level CalDAV and/or CardDAV abstractions, I strongly recommend those since that api is largely stable.