класс ActionCable::Channel::TestCase

Базовый класс для функциональных тестов каналов Action Cable.

Пример основного использования

Функциональные тесты пишутся следующим образом: 1. Сначала используется метод subscribe для имитации создания подписки. 2. Затем проверяется, соответствует ли текущее состояние ожидаемому. «Состояние» может быть чем угодно: переданные сообщения, подписки на потоки и т. д.

Например:

class ChatChannelTest < ActionCable::Channel::TestCase
  def test_subscribed_with_room_number
    # Simulate a subscription creation
    subscribe room_number: 1

    # Asserts that the subscription was successfully created
    assert subscription.confirmed?

    # Asserts that the channel subscribes connection to a stream
    assert_has_stream "chat_1"

    # Asserts that the channel subscribes connection to a specific
    # stream created for a model
    assert_has_stream_for Room.find(1)
  end

  def test_does_not_stream_with_incorrect_room_number
    subscribe room_number: -1

    # Asserts that not streams was started
    assert_no_streams
  end

  def test_does_not_subscribe_without_room_number
    subscribe

    # Asserts that the subscription was rejected
    assert subscription.rejected?
  end
end

Вы также можете выполнять действия: def test_perform_speak subscribe room_number: 1

  perform :speak, message: "Hello, Rails!"

  assert_equal "Hello, Rails!", transmissions.last["text"]
end

Специальные методы

ActionCable::Channel::TestCase также автоматически предоставляет следующие методы экземпляра для использования в тестах:

connection

Объект ActionCable::Channel::ConnectionStub, представляющий текущее HTTP-соединение.

subscription

Экземпляр текущего канала, созданный при вызове subscribe.

transmissions

Список всех сообщений, переданных в канал.

Автоматическое определение канала

ActionCable::Channel::TestCase автоматически определит канал, на котором будет выполняться тест, по имени класса теста. Если канал нельзя определить по имени класса теста, вы можете явно задать его с помощью tests.

class SpecialEdgeCaseChannelTest < ActionCable::Channel::TestCase
  tests SpecialChannel
end

Указание идентификаторов соединения

Вам нужно вручную настроить соединение, чтобы предоставить значения для идентификаторов. Для этого просто используйте:

stub_connection(user: users(:john))

Тестирование вещания

ActionCable::Channel::TestCase расширяет утверждения ActionCable::TestHelper (например, assert_broadcasts) для обработки вещания моделям:

# in your channel
def speak(data)
  broadcast_to room, text: data["message"]
end

def test_speak
  subscribe room_id: rooms(:chat).id

  assert_broadcast_on(rooms(:chat), text: "Hello, Rails!") do
    perform :speak, message: "Hello, Rails!"
  end
end