класс 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_broadcasts_on(rooms(:chat), text: "Hello, Rails!") do
    perform :speak, message: "Hello, Rails!"
  end
end