vk-fast-longpoll's Introduction

vk-fast-longpoll

RU | Мощный инструмент для работы с VK API, который работает в 25 раз быстрее обычных вызовов API методов.

EN | Powerfull tool for VK api that works 25 times faster then usual api calls

Русский

Установка и начало работы

Установка

npm install vk-fast-longpoll --save

Инициализация

const VK = require('vk-fast-longpoll');
const group = new VK('token here');

Запуск longpoll соединения

group.longpoll.start();

Начинаем слушать сообщения

group.longpoll.on('message', (message) => {
    if(!message.isOutbox)
    {
        //Отвечаем на сообщение
    }
});

Вызов API методов

Все методы VK должны вызываться с префиксом api например

group.api.messages.send({user_id: 1, message: 'Привет, Паша'});

Методы возвращают Promise-ы, поэтому стоит добавлять обработчик ошибок к каждому вызову.

group.api.messages.send({user_id: 1, message: 'Привет, Паша'}).catch(console.error);

Все названия методов, а также названия полей полностью соответсвуют названиям из документации VK

Echo пример

const VK = require('vk-fast-longpoll');
const group = new VK('token here');

group.longpoll.start();

group.longpoll.on('message', (message) => {
    if(!message.isOutbox)
    {
        group.api.messages.send({user_id: message.sender, message: message.text}).then(() => {
            console.log(message.text);
        }).catch(console.error);
    }
});

Загрузка файлов

//В разработке

English

Installing and getting started

Installing

npm install vk-io --save

Initializing

const VK = require('vk-fast-longpoll');
const group = new VK('token here');

Longpoll connection start

group.longpoll.start();

Listen to messages

group.longpoll.on('message', (message) => {
    if(!message.isOutbox)
    {
        //Reply message
    }
});

API method calls

All VK Api methods must be called with api prefix

group.api.messages.send({user_id: 1, message: 'Hello, Pasha'});

All methods return Promises, therefor you need to catch errors in every api call.

group.api.messages.send({user_id: 1, message: 'Hello, Pasha'}).catch(console.error);

All methods names and fields names are equal as VK Api docs

Echo example

const VK = require('vk-fast-longpoll');
const group = new VK('token here');

group.longpoll.start();

group.longpoll.on('message', (message) => {
    if(!message.isOutbox)
    {
        group.api.messages.send({user_id: message.sender, message: message.text}).then(() => {
            console.log(message.text);
        }).catch(console.error);
    }
});

File uploading

//In development

vk-fast-longpoll's People

Contributors

Stargazers

Watchers

vk-fast-longpoll's Issues

Добавить событие на кик/добавление юзера в чате

Доброго дня, очень понравилась ваша библиотека, но в ней не хватает возможности детально получить сообщение об операции добавления или удаления пользователя из чата.
Насколько я знаю, longpoll вк присылает их в виде:
source_act: chat_kick_user (удаление),
source_act: chat_invite_user (добавление)
И в source_mid содержится id кикнутого/добавленого пользователя.

В идеале, хотелось бы видеть обработчики на все доступные source_act (chat_create, chat_title_update, chat_photo_update, chat_invite_user, chat_kick_user).

Если возможно реализовать, буду благодарен :)

Recommend Projects

emcifuntik / vk-fast-longpoll Goto Github PK