Fetch

For FastAPI or other HTTP backends, use this fetch from pyloid-js.

For PyloidRPC backend, use rpc instead.

The pyloid fetch provides automatic window ID injection and server URL resolution for seamless backend communication.

Key Features

Automatic Window ID: Injects X-Pyloid-Window-Id header for request routing
Server URL Resolution: Combines relative paths with the Pyloid server URL
Drop-in Replacement: Same API as native fetch() - works with any HTTP library
Lazy Initialization: Automatically waits for Pyloid to be ready

Basic Usage

Frontend

import { fetch } from 'pyloid-js';

// Fetch the 'greet' function to receive a greeting.
fetch(`/greet?name=Alice`)
  .then(response => response.text())
  .then(data => console.log(data));

Backend

Create a server instance
Create a start server function
Create a setup cors function
Create an adapter instance and pass the start and setup cors functions
Pass the adapter instance to the server parameter of the Pyloid class

if you want to access the pyloid context, you can use the adapter.get_context(window_id) function.

if you want to check if the request is a pyloid request, you can use the adapter.is_pyloid(window_id) function.

from pyloid_adapter import BaseAdapter, PyloidContext
from fastapi import FastAPI
from fastapi import Request
from fastapi.middleware.cors import CORSMiddleware

# 1. Create a server instance
app = FastAPI()

# 2. Create a start server function
def start(host: str, port: int):
	import uvicorn
	uvicorn.run(app, host=host, port=port)

# 3. Create a setup cors function
def setup_cors():
	app.add_middleware(
		CORSMiddleware,
		allow_origins=['*'],
		allow_credentials=True,
		allow_methods=['*'],
		allow_headers=['*'],
	)

# 4. Create an adapter instance and pass the start and setup cors functions
adapter = BaseAdapter(start, setup_cors)


@app.get('/greet')
async def greet(name: str):
	return f'Hello, {name}!'


@app.get('/create_window')
async def create_window(request: Request):
	window_id = request.headers.get("X-Pyloid-Window-Id")
 
	if adapter.is_pyloid(window_id):
		print("pyloid request")
	else:
		print("not pyloid request")
  
	ctx: PyloidContext = adapter.get_context(window_id) 
 
	win = ctx.pyloid.create_window(title='Google Window')
	win.load_url('https://www.google.com')
	win.show_and_focus()

this example is for fastapi backend.

you can use any server backend.

Fetch

Key Features

Basic Usage

Frontend

Backend

On this page