docs and collection snapshots

src/test/SnapshotAssertions.php

@@ -15,6 +15,20 @@
  * it('matches dom lists')->get('/')->querySelector('h1')->assertMatchesSnapshot();
  * it('matches views')->renderTemplate('_news/entry', $variables)->assertMatchesSnapshot();
  * ```
+ *
+ * ## Elements
+ *
+ * Many elements can be snapshotted as well. Unfortunately, Pest is not smart enough to properly
+ * snapshot elements so you must call `->toSnapshot()` on them first.
+ *
+ * ```php
+ * it('imports entries', function () {
+ *   $this->importEntries();
+ *   $entries = Entry::find()->section('news')->collect();
+ *
+ *   expect($entries->map->toSnapshot())->toMatchSnapshot();
+ * });
+ * ```
  */
 trait SnapshotAssertions
 {

tests/.pest/snapshots/SnapshotTest/it_matches_collected_snapshots.snap

@@ -0,0 +1 @@
+[{"expiryDate":null,"deletedWithEntryType":false,"_authorId":null,"tempId":null,"draftId":null,"revisionId":null,"isProvisionalDraft":false,"enabled":true,"archived":false,"siteId":2,"title":"Entry 0","slug":"entry-0","uri":"posts\/entry-0","dateLastMerged":null,"dateDeleted":null,"trashed":false,"isNewForSite":false,"isDraft":false,"isRevision":false,"isUnpublishedDraft":false,"ref":"posts\/entry-0","status":"live","structureId":null,"url":"http:\/\/localhost:8080\/index.php?p=posts\/entry-0","authorId":null},{"expiryDate":null,"deletedWithEntryType":false,"_authorId":null,"tempId":null,"draftId":null,"revisionId":null,"isProvisionalDraft":false,"enabled":true,"archived":false,"siteId":2,"title":"Entry 1","slug":"entry-1","uri":"posts\/entry-1","dateLastMerged":null,"dateDeleted":null,"trashed":false,"isNewForSite":false,"isDraft":false,"isRevision":false,"isUnpublishedDraft":false,"ref":"posts\/entry-1","status":"live","structureId":null,"url":"http:\/\/localhost:8080\/index.php?p=posts\/entry-1","authorId":null},{"expiryDate":null,"deletedWithEntryType":false,"_authorId":null,"tempId":null,"draftId":null,"revisionId":null,"isProvisionalDraft":false,"enabled":true,"archived":false,"siteId":2,"title":"Entry 2","slug":"entry-2","uri":"posts\/entry-2","dateLastMerged":null,"dateDeleted":null,"trashed":false,"isNewForSite":false,"isDraft":false,"isRevision":false,"isUnpublishedDraft":false,"ref":"posts\/entry-2","status":"live","structureId":null,"url":"http:\/\/localhost:8080\/index.php?p=posts\/entry-2","authorId":null}]

tests/SnapshotTest.php

@@ -64,3 +64,10 @@
 
     expect($entry)->toMatchElementSnapshot();
 });
+
+it('matches collected snapshots', function () {
+    Entry::factory()->section('posts')->count(3)->sequence(fn ($index) => ['title' => 'Entry '.$index])->create();
+    $entries = \craft\elements\Entry::find()->section('posts')->collect();
+
+    expect($entries->map->toSnapshot())->toMatchSnapshot();
+});