osa-contacts
v1.0.0
Published
Access contact information on OSX with Node.JS
Downloads
7
Maintainers
Readme
osa-contacts
A node.js module to access contact information on OSX
Installation
Requires OSX 10.10 Yosemite.
npm install osa-contacts
Usage
###Get info about a contact
var contacts = require('osa-contacts');
// First param: query object (see below)
contacts.getContacts({ name: 'Johnny Appleseed' }, function(err, data) {
// Data is an array of contact objects (see below)
});
The query object contains requirements for a contact to be returned. All conditions must be met for the contact to be returned.
Example query objects:
// Person with the name 'Johnny Appleseed'
{
'name': 'Johnny Appleseed'
}
// People with the first name 'Alice'
{
'firstName': 'Alice'
}
// People with the last name 'Liddell'
{
'lastName': 'Liddell'
}
Example contact object:
{
'id': 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX:ABPerson',
'first': 'Johnny',
'last': 'Appleseed',
'nickname': null,
'addresses': [
{
'city': 'Cupertino',
'street': '1 Infinite Loop',
'zip': '95014',
'country': 'United States',
'state': 'CA',
'formattedAddress': '1 Infinite Loop\nCupertino CA 95014\nUnited States'
}
],
'phones': [
'+1 (555) 555-5555'
]
}
###Get a person's contact photo
var contacts = require('osa-contacts');
contacts.getContacts({ name: 'Johnny Appleseed' }, function(err, data) {
var john = data[0];
// First param - contact object or string id
// Second param - if true, getPicture will return the cropped version
contacts.getPicture(john, true, function(err, data) {
// Data is a Buffer of the JPG image file
});
});