PocketBase: 10 Code-Beispiele zum Arbeiten mit Collections

Q: Was ist der Unterschied zwischen getList() und getFullList()?

getList() liefert genau eine Seite mit Paginierungsinfos und eignet sich für Listenansichten. getFullList() lädt alle passenden Records, indem es intern mehrere Seiten abruft. Nutze es nur, wenn Du wirklich alle Daten brauchst.

Q: Wie schütze ich meine Collection vor unbefugtem Zugriff?

Über die API-Regeln der Collection: listRule, viewRule, createRule, updateRule und deleteRule. Mit Ausdrücken wie author = @request.auth.id legst Du fest, dass nur der Besitzer einen Record ändern darf.

Lesedauer 6 Minuten

PocketBase ist ein komplettes Backend in einer einzigen Datei: Datenbank, Authentifizierung, Datei-Uploads, Realtime und ein Admin-Dashboard. Das Herzstück sind die Collections. In ihnen speicherst Du Deine Daten, definierst Felder und legst fest, wer was lesen und schreiben darf.

In diesem Beitrag zeige ich Dir 10 praxisnahe Code-Beispiele, mit denen Du Collections über das offizielle JavaScript SDK anlegst, abfragst, filterst, änderst und in Echtzeit beobachtest. Die Beispiele lassen sich sehr einfach auf andere Sprachen übertragen.

Was sind Collections in PocketBase?

Eine Collection entspricht grob einer Tabelle in einer relationalen Datenbank. Jeder Eintrag darin heißt Record. PocketBase kennt drei Arten von Collections:

Base Collections für ganz normale Daten wie Beiträge, Produkte oder Aufgaben.
Auth Collections für Benutzer, inklusive Passwort, E-Mail-Verifizierung und OAuth2.
View Collections als schreibgeschützte Sicht auf Daten, definiert über eine SQL-SELECT-Abfrage.

Vorbereitung: Das JavaScript SDK einrichten

Für alle Beispiele brauchst Du eine laufende PocketBase-Instanz (standardmäßig unter http://127.0.0.1:8090) und das SDK. Installiere es mit npm:

npm install pocketbase

1	npm install pocketbase

Danach erzeugst Du eine Client-Instanz, die Du in allen folgenden Beispielen verwendest:

import PocketBase from 'pocketbase';

const pb = new PocketBase('http://127.0.0.1:8090');

import PocketBase from 'pocketbase';

const pb = new PocketBase('http://127.0.0.1:8090');

Die Beispiele beziehen sich auf eine Collection posts mit den Feldern title (Text), content (Editor), published (Bool), author (Relation zu users) und cover (Datei). Sie basieren auf PocketBase ab Version 0.23, in der die Felder einer Collection unter fields definiert werden und Admins als _superusers geführt werden.

Beispiel 1: Eine Collection per Code anlegen

Collections klickst Du normalerweise im Dashboard zusammen. Du kannst sie aber auch per Code erstellen, etwa für Setup-Skripte. Dafür musst Du Dich als Superuser anmelden:

await pb.collection('_superusers').authWithPassword('admin@example.com', 'geheimesPasswort');

const collection = await pb.collections.create({
  name: 'posts',
  type: 'base',
  fields: [
    { name: 'title', type: 'text', required: true, max: 200 },
    { name: 'content', type: 'editor' },
    { name: 'published', type: 'bool' },
    { name: 'cover', type: 'file', maxSelect: 1, maxSize: 5242880 }
  ],
  listRule: 'published = true',
  viewRule: 'published = true',
  createRule: '@request.auth.id != ""',
  updateRule: 'author = @request.auth.id',
  deleteRule: 'author = @request.auth.id'
});

console.log('Collection angelegt:', collection.id);

await pb.collection('_superusers').authWithPassword('admin@example.com', 'geheimesPasswort');

const collection = await pb.collections.create({

name: 'posts',

type: 'base',

fields: [

{ name: 'title', type: 'text', required: true, max: 200 },

{ name: 'content', type: 'editor' },

{ name: 'published', type: 'bool' },

{ name: 'cover', type: 'file', maxSelect: 1, maxSize: 5242880 }

listRule: 'published = true',

viewRule: 'published = true',

createRule: '@request.auth.id != ""',

updateRule: 'author = @request.auth.id',

deleteRule: 'author = @request.auth.id'

});

console.log('Collection angelegt:', collection.id);

Die Regeln (listRule, createRule usw.) sind das Berechtigungssystem von PocketBase. Ein leerer String bedeutet: jeder darf. null bedeutet: nur Superuser dürfen.

Beispiel 2: Einen Record erstellen

Einen neuen Eintrag legst Du mit create() an. Du übergibst einfach ein Objekt mit den Feldwerten:

const record = await pb.collection('posts').create({
  title: 'Mein erster Beitrag',
  content: '<p>Hallo PocketBase!</p>',
  published: true,
  author: pb.authStore.record.id
});

console.log(record.id, record.created);

const record = await pb.collection('posts').create({

title: 'Mein erster Beitrag',

content: '<p>Hallo PocketBase!</p>',

published: true,

author: pb.authStore.record.id

});

console.log(record.id, record.created);

PocketBase vergibt automatisch eine 15-stellige id sowie die Zeitstempel created und updated, sofern diese Autodate-Felder in der Collection vorhanden sind.

Beispiel 3: Einen einzelnen Record laden

Kennst Du die ID, holst Du den Eintrag mit getOne():

const post = await pb.collection('posts').getOne('abc123def456ghi');

console.log(post.title);

const post = await pb.collection('posts').getOne('abc123def456ghi');

console.log(post.title);

Suchst Du stattdessen nach einem bestimmten Feldwert, etwa einem Slug, nimmst Du getFirstListItem(). Diese Methode liefert den ersten Treffer und wirft einen 404-Fehler, wenn nichts gefunden wird:

const post = await pb.collection('posts').getFirstListItem('slug = "mein-erster-beitrag"');

1	const post = await pb.collection('posts').getFirstListItem('slug = "mein-erster-beitrag"');

Beispiel 4: Listen mit Paginierung abrufen

Für Listenansichten nutzt Du getList(). Du gibst Seite und Anzahl pro Seite an und bekommst neben den Einträgen auch Infos zur Gesamtmenge:

const result = await pb.collection('posts').getList(1, 20, {
  sort: '-created'
});

console.log(result.items);       // die Records dieser Seite
console.log(result.totalItems);  // Gesamtzahl aller Treffer
console.log(result.totalPages);  // Anzahl der Seiten

const result = await pb.collection('posts').getList(1, 20, {

sort: '-created'

});

console.log(result.items); // die Records dieser Seite

console.log(result.totalItems); // Gesamtzahl aller Treffer

console.log(result.totalPages); // Anzahl der Seiten

Brauchst Du wirklich alle Einträge auf einmal, etwa für einen Export, gibt es getFullList(). Das SDK lädt dann intern Seite für Seite nach:

const allPosts = await pb.collection('posts').getFullList({
  sort: 'title',
  batch: 500
});

const allPosts = await pb.collection('posts').getFullList({

sort: 'title',

batch: 500

});

Beispiel 5: Filtern und Sortieren

Die Filtersyntax von PocketBase ist kompakt und mächtig. Du kombinierst Bedingungen mit && und ||, und mit ~ suchst Du nach Teilstrings:

const result = await pb.collection('posts').getList(1, 10, {
  filter: 'published = true && created >= "2026-01-01 00:00:00"',
  sort: '-created,title'
});

const result = await pb.collection('posts').getList(1, 10, {

filter: 'published = true && created >= "2026-01-01 00:00:00"',

sort: '-created,title'

});

Wichtig: Wenn Werte aus Benutzereingaben stammen, baue den Filter nie per String-Verkettung zusammen. Nutze pb.filter() mit Platzhaltern, dann kümmert sich das SDK um das korrekte Escaping:

const suchbegriff = 'Pocket"Base';

const result = await pb.collection('posts').getList(1, 10, {
  filter: pb.filter('title ~ {:q} && published = {:pub}', {
    q: suchbegriff,
    pub: true
  })
});

const suchbegriff = 'Pocket"Base';

const result = await pb.collection('posts').getList(1, 10, {

filter: pb.filter('title ~ {:q} && published = {:pub}', {

q: suchbegriff,

pub: true

})

});

Beispiel 6: Relationen mit expand auflösen

Relationsfelder speichern nur die IDs der verknüpften Records. Mit expand lädst Du die kompletten Datensätze in einem einzigen Request mit:

const post = await pb.collection('posts').getOne('abc123def456ghi', {
  expand: 'author'
});

console.log(post.expand.author.name);

const post = await pb.collection('posts').getOne('abc123def456ghi', {

expand: 'author'

});

console.log(post.expand.author.name);

Du kannst auch mehrere Relationen und verschachtelte Ebenen auflösen, zum Beispiel expand: 'author,comments_via_post.user'. Die Schreibweise comments_via_post ist eine sogenannte Back-Relation: Sie holt alle Kommentare, deren Feld post auf diesen Beitrag zeigt. Mit fields begrenzt Du außerdem, welche Felder überhaupt zurückkommen:

const result = await pb.collection('posts').getList(1, 20, {
  expand: 'author',
  fields: 'id,title,expand.author.name'
});

const result = await pb.collection('posts').getList(1, 20, {

expand: 'author',

fields: 'id,title,expand.author.name'

});

Beispiel 7: Einen Record aktualisieren

Mit update() änderst Du einen bestehenden Eintrag. Du musst nur die Felder mitschicken, die sich ändern sollen:

const updated = await pb.collection('posts').update('abc123def456ghi', {
  title: 'Neuer Titel',
  published: false
});

const updated = await pb.collection('posts').update('abc123def456ghi', {

title: 'Neuer Titel',

published: false

});

Für Zahlen und Mehrfachfelder gibt es praktische Modifikatoren. views+ erhöht einen Zähler, tags+ hängt einen Wert an, tags- entfernt ihn:

await pb.collection('posts').update('abc123def456ghi', {
  'views+': 1,
  'tags+': 'tutorial',
  'tags-': 'entwurf'
});

await pb.collection('posts').update('abc123def456ghi', {

'views+': 1,

'tags+': 'tutorial',

'tags-': 'entwurf'

});

Beispiel 8: Dateien hochladen

Für Datei-Felder übergibst Du ein FormData-Objekt oder direkt ein File/Blob im Datenobjekt. Das SDK wandelt es automatisch in einen Multipart-Request um:

const fileInput = document.querySelector('#cover');

const post = await pb.collection('posts').update('abc123def456ghi', {
  cover: fileInput.files[0]
});

// URL zur Datei erzeugen, optional mit Thumbnail
const url = pb.files.getURL(post, post.cover, { thumb: '400x300' });

const fileInput = document.querySelector('#cover');

const post = await pb.collection('posts').update('abc123def456ghi', {

cover: fileInput.files[0]

});

// URL zur Datei erzeugen, optional mit Thumbnail

const url = pb.files.getURL(post, post.cover, { thumb: '400x300' });

Um eine Datei wieder zu entfernen, setzt Du das Feld auf einen leeren Wert, also cover: null. Bei Mehrfachdateien entfernst Du gezielt eine Datei mit 'cover-': ['dateiname.jpg'].

Beispiel 9: Einen Record löschen

Das Löschen ist der einfachste Teil:

await pb.collection('posts').delete('abc123def456ghi');

1	await pb.collection('posts').delete('abc123def456ghi');

Beachte dabei die Einstellungen Deiner Relationsfelder. Ist bei einer Relation cascadeDelete aktiviert, werden abhängige Records automatisch mitgelöscht. Ist das Feld als Pflichtfeld markiert und die Kaskade deaktiviert, schlägt das Löschen fehl, solange noch Verweise existieren.

Beispiel 10: Realtime-Änderungen abonnieren

Eine der stärksten Funktionen von PocketBase: Du kannst Collections in Echtzeit beobachten. Bei jeder Änderung bekommst Du ein Event mit der Aktion und dem betroffenen Record:

// Alle Änderungen der Collection beobachten
const unsubscribe = await pb.collection('posts').subscribe('*', (e) => {
  console.log(e.action); // 'create', 'update' oder 'delete'
  console.log(e.record);
}, {
  filter: 'published = true'
});

// Nur einen bestimmten Record beobachten
await pb.collection('posts').subscribe('abc123def456ghi', (e) => {
  console.log('Beitrag geändert:', e.record.title);
});

// Später wieder abmelden
unsubscribe();

// Alle Änderungen der Collection beobachten

const unsubscribe = await pb.collection('posts').subscribe('*', (e) => {

console.log(e.action); // 'create', 'update' oder 'delete'

console.log(e.record);

}, {

filter: 'published = true'

});

// Nur einen bestimmten Record beobachten

await pb.collection('posts').subscribe('abc123def456ghi', (e) => {

console.log('Beitrag geändert:', e.record.title);

});

// Später wieder abmelden

unsubscribe();

Realtime-Events respektieren die listRule und viewRule Deiner Collection. Ein Benutzer bekommt also nur Events für Records, die er auch lesen dürfte.

Bonus: Mehrere Operationen als Batch ausführen

Seit Version 0.23 kannst Du mehrere Create-, Update- und Delete-Aufrufe in einer einzigen Transaktion bündeln. Schlägt ein Teil fehl, wird alles zurückgerollt. Die Batch API musst Du vorher in den Einstellungen des Dashboards aktivieren:

const batch = pb.createBatch();

batch.collection('posts').create({ title: 'Teil 1', published: true });
batch.collection('posts').create({ title: 'Teil 2', published: true });
batch.collection('posts').delete('altesId1234567');

const results = await batch.send();

const batch = pb.createBatch();

batch.collection('posts').create({ title: 'Teil 1', published: true });

batch.collection('posts').create({ title: 'Teil 2', published: true });

batch.collection('posts').delete('altesId1234567');

const results = await batch.send();

Der Lebenszyklus eines Records

Die folgende Grafik fasst zusammen, welche SDK-Methode Du für welchen Schritt brauchst:

Tipps für die Praxis

Fehler abfangen: Jede SDK-Methode wirft bei Problemen einen ClientResponseError. Über err.status und err.response.data siehst Du genau, welches Feld die Validierung nicht bestanden hat.
Auto-Cancellation beachten: Das SDK bricht doppelte, gleichzeitige Requests automatisch ab. Brauchst Du parallele Aufrufe, übergib requestKey: null in den Optionen.
Regeln statt Client-Logik: Prüfe Berechtigungen immer über die API-Regeln der Collection und nicht nur im Frontend. Nur dann sind Deine Daten wirklich geschützt.
Indizes anlegen: Filterst oder sortierst Du häufig nach einem Feld, lege im Dashboard einen Index dafür an. Das beschleunigt große Collections deutlich.

Alle Methoden und Optionen findest Du ausführlich in der offiziellen PocketBase-Dokumentation und im GitHub-Repository des JavaScript SDK.

Fazit

Mit diesen 10 Code-Beispielen hast Du das komplette Handwerkszeug, um mit PocketBase Collections zu arbeiten: anlegen, Records erstellen, lesen, filtern, Relationen auflösen, aktualisieren, Dateien hochladen, löschen und Änderungen in Echtzeit verfolgen. Das Schöne an PocketBase ist, dass all das mit sehr wenig Code funktioniert. Starte am besten mit einer kleinen Test-Collection, probiere die Beispiele nacheinander aus und baue darauf Dein eigenes Projekt auf.

Häufige Fragen zu PocketBase Collections

Brauche ich für PocketBase Collections SQL-Kenntnisse?

Nein. Base und Auth Collections legst Du komplett über das Dashboard oder das SDK an. SQL brauchst Du nur für View Collections, die auf einer SELECT-Abfrage basieren.

Was ist der Unterschied zwischen getList() und getFullList()?

getList() liefert genau eine Seite mit Paginierungsinfos und eignet sich für Listenansichten. getFullList() lädt alle passenden Records, indem es intern mehrere Seiten abruft. Nutze es nur, wenn Du wirklich alle Daten brauchst.

Wie schütze ich meine Collection vor unbefugtem Zugriff?

Über die API-Regeln der Collection: listRule, viewRule, createRule, updateRule und deleteRule. Mit Ausdrücken wie author = @request.auth.id legst Du fest, dass nur der Besitzer einen Record ändern darf.

Kann ich Collections zwischen Entwicklung und Produktion übertragen?

Ja. Im Dashboard kannst Du unter den Einstellungen alle Collections als JSON exportieren und in einer anderen Instanz importieren. Alternativ nutzt Du die Migrationen von PocketBase, die Änderungen an Collections automatisch als Dateien protokollieren.

Funktionieren die Beispiele auch mit älteren PocketBase-Versionen?

Größtenteils ja, aber nicht vollständig. Vor Version 0.23 hießen die Felddefinitionen schema statt fields, Admins meldeten sich über pb.admins an und die Batch API gab es noch nicht. Ein Update lohnt sich daher.

Name	Borlabs Cookie
Anbieter	Eigentümer dieser Website, keine Übermittlung von Daten and Dritte, Impressum
Zweck	Speichert die Einstellungen der Besucher, die in der Cookie Box ausgewählt wurden.
Cookie Name	borlabs-cookie
Cookie Laufzeit	1 Jahr

Name	Wordpress Application Firewall
Anbieter	Eigentümer dieser Website, keine Übermittlung von Daten and Dritte.
Zweck	Essentielles Session-Cookie um die Sicherheit unserer Website zu gewährleisten. Identifiziert den Besucher anhand einer anonymen ID um mehrfache Hackversuche wiederkehrender Besucher zu verhindern.
Cookie Name	icwp-wpsf

Name	Wordpress Login Session
Anbieter	Eigentümer dieser Website, keine Übermittlung von Daten and Dritte.
Zweck	Dieses Session Cookie speichert den Zustand unseres Login-Bereichs, um festzustellen ob ein User eingeloggt ist oder nicht.
Cookie Name	swpm_session

Name	PHP Session ID
Anbieter	Eigentümer dieser Website, keine Übermittlung von Daten and Dritte
Zweck	Dieses Session-Cookie wird benötigt um die einwandfreie Navigation auf unseren Seiten zu gewährleisten. Es identifiziert den Besucher anhand einer anonymen ID.
Cookie Name	PHPSESSID

Name	WooCommerce
Anbieter	Eigentümer dieser Website, keine Übermittlung von Daten and Dritte
Zweck	Dieses Cookie wird zur Funktionalität des WooCommerce Onlineshops benötigt.
Cookie Name	woocommerce_cart_hash, tk_ai

Akzeptieren	Google Analytics
Name	Google Analytics
Anbieter	Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Zweck	Cookie von Google für Website-Analysen. Erzeugt statistische, anonymisierte Daten darüber, wie der Besucher die Website nutzt. Google Analytics hilft uns, unser Angebot auf unsere Besucher besser abstimmen zu können.
Datenschutzerklärung	https://policies.google.com/privacy
Cookie Name	_ga,_gat,_gid
Cookie Laufzeit	1 Jahre

Akzeptieren	Vimeo
Name	Vimeo
Anbieter	Vimeo Inc., 555 West 18th Street, New York, New York 10011, USA
Zweck	Wird verwendet, um Vimeo-Inhalte zu entsperren.
Datenschutzerklärung	https://vimeo.com/privacy
Host(s)	player.vimeo.com
Cookie Name	vuid
Cookie Laufzeit	2 Jahre

Akzeptieren	YouTube
Name	YouTube
Anbieter	Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Zweck	Wird verwendet, um YouTube-Inhalte zu entsperren.
Datenschutzerklärung	https://policies.google.com/privacy
Host(s)	google.com
Cookie Name	NID
Cookie Laufzeit	6 Monate