Pruebas
En esta página
SocialPublisher::fake() sustituye cualquier llamada a la API por un doble que registra cada post: tus pruebas comprueban lo que se habría publicado, y dónde, sin red ni clave API.
El doble
use QuietSocial\Sdk\Post;
use QuietSocial\Social\Facades\SocialPublisher;
it('publishes a published article to LinkedIn', function (): void {
$fake = SocialPublisher::fake();
Article::factory()->create(['is_published' => true]);
$fake->assertPublished(Article::class, fn (Post $post, array $to): bool => in_array('linkedin', $to, true));
});
El doble sirve tanto a la sincronización automática como al constructor manual: no sale nada, y cada post queda registrado.
Las aserciones
| Método | Comprueba |
|---|---|
assertPublished(Article::class, ?Closure $check) |
Se ha enviado un post de esta clase, y uno de ellos pasa la comprobación, que recibe el Post y sus destinos. |
assertCancelled(Article::class, ?Closure $check) |
Se ha cancelado un post de esta clase; la comprobación recibe el Post tal como se había enviado. |
assertNothingPublished() |
No se ha enviado ningún post. |
published() devuelve cada Post enviado, en orden. Una aserción que falla dice lo que se ha publicado, y pasa por PHPUnit cuando está instalado.
Lo que hace el doble
- Las publicaciones falsas quedan programadas (o en borrador, o pendientes de validación, según el post) y pueden cancelarse.
- Cada red tiene un destino capaz de publicar: un modelo sin destinos explícitos apunta a todas las redes que declara.
markPublished(?string $class)hace pasar las publicaciones falsas, de todas las clases o de una sola, por publicadas: la siguiente modificación de su modelo emiteSocialPostOutdateden lugar de sustituirlas.
use Illuminate\Support\Facades\Event;
use QuietSocial\Social\Events\SocialPostOutdated;
Event::fake([SocialPostOutdated::class]);
$fake = SocialPublisher::fake();
$article = Article::factory()->create(['is_published' => true]);
$fake->markPublished(Article::class);
$article->update(['excerpt' => 'Corregido tras la publicación.']);
Event::assertDispatched(SocialPostOutdated::class);
Falsea solo los eventos del paquete: un Event::fake() sin lista también falsea los eventos de Eloquent, y entonces ningún guardado dispara la sincronización.
La cola y la caché
Con la cola sync (la de una suite de pruebas de Laravel por defecto), el job se ejecuta durante el guardado y el doble ve el post enseguida.
Con Queue::fake(), el job no se ejecuta en absoluto y nada llega al doble: comprueba más bien que el job se ha puesto en cola.
use Illuminate\Support\Facades\Queue;
use QuietSocial\Social\Jobs\SyncSocialPost;
Queue::fake();
Article::factory()->create(['is_published' => true]);
Queue::assertPushed(SyncSocialPost::class);
La caché array de una suite de pruebas admite bloqueos: la sincronización se ejecuta en ella como en producción.