npmpackage.info

Gathering detailed insights and metrics for preact-ssr-prepass

Other packages similar to preact-ssr-prepass

@mo36924/preact-ssr-prepass

1.2.2

react-ssr-prepass drop-in replacement for preact-x

Gathering detailed insights and metrics for preact-ssr-prepass

preact-ssr-prepass - 1.2.2 | npmpackage.info

preact-ssr-prepass

Drop-in replacement for react-ssr-prepass

1.2.2

JavaScript

89.60 kB

2.8

Installations

npm install preact-ssr-prepass

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS, ESM

Node Version

22.4.0

NPM Version

10.8.1 Pull Requests

Open

11

Total

52

Closed

9

Merged

32

Issues

Open

3

Total

11

Closed

8

Releases

v1.2.2

Updated on Jul 14, 2024

v1.2.1

Updated on Nov 21, 2023

1.2.0

v1.2.0

Updated on Oct 06, 2021

1.1.3

v1.1.3

Updated on Jan 11, 2021

1.1.2

v1.1.2

Updated on Oct 14, 2020

1.1.1

v1.1.1

Updated on Aug 06, 2020

View All 9 releases

Languages

JavaScript

TypeScript

JavaScript (97.4%)

TypeScript (2.6%)

Developer

sventschui

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

49 Stars

76 Commits

7 Forks

2 Watchers

12 Branches

19 Contributors

Updated on Nov 22, 2024

Maintainers

View All 19 Contributors

Package Meta Information

Latest Version

1.2.2

Package Id

preact-ssr-prepass@1.2.2

Unpacked Size

89.60 kB

Size

15.18 kB

File Count

NPM Version

10.8.1

Node Version

22.4.0

Published on

Jul 14, 2024

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Peer Dependencies

preact

Dev Dependencies

@babel/core @babel/preset-env @babel/preset-react babel-eslint babel-jest coveralls flow-bin flow-copy-source flow-typed jest lint-staged microbundle preact preact-render-to-string prettier rimraf typescript

preact-ssr-prepass

Drop-in replacement for react-ssr-prepass.

Neither Preact nor React support Suspense on the server as of now. Heavily inspired by react-ssr-prepass, preact-ssr-prepass provides a two-pass approach with which Suspense can be used on the server. In the first pass, preact-ssr-prepass will create a VNode tree and await all suspensions, in the second pass preact-render-to-string can be used to render a vnode to a string.

Even if preact-ssr-prepass is designed to do as little as possible, it still adds a slight overhead since the VNode tree is created twice.

⚠️ Note that this is neither an official Preact nor React API and that the way Suspense is handled on the server might/will change in the future!

Usage / API

Awaiting suspensions

preact-ssr-prepass needs to be called just before rendering a vnode to a string. See the following example:

lazy.js:

1export default function LazyLoaded() {
2    return <div>I shall be loaded and rendered on the server</div>
3}

index.js:

1import { createElement as h } from 'preact';
2import { Suspense, lazy } from 'preact/compat';
3import renderToString from 'preact-render-to-string';
4import prepass from 'preact-ssr-prepass';
5
6const LazyComponent = lazy(() => import('./lazy'));
7
8const vnode = (
9    <Suspense fallback={<div>I shall not be rendered on the server</div>}>
10        <LazyComponent />
11    </Suspense>
12);
13
14prepass(vnode)
15    .then(() => {
16        // <div>I shall be loaded and rendered on the server</div>
17        console.log(renderToString(vnode));
18    });

Custom suspensions/data fetching using the visitor

preact-ssr-prepass accepts a second argument that allows you to suspend on arbitrary elements:

1ssrPrepass(<App />, (element, instance) => {
2  if (instance !== undefined && typeof instance.fetchData === 'function') {
3    return instance.fetchData()
4  }
5});

API

1/**
2 * Visitor function to suspend on certain elements.
3 * 
4 * When this function returns a Promise it is awaited before the vnode will be rendered.
5 */
6type Visitor = (element: preact.VNode, instance: ?preact.Component) => ?Promise<any>;
7
8/**
9 * The default export of preact-ssr-prepass
10 *
11 * @param{vnode} preact.VNode The vnode to traverse
12 * @param{visitor} ?Visitor A function that is called for each vnode and might return a Promise to suspend.
13 * @param{context} ?Object Initial context to be used when traversing the vnode tree
14 * @return Promise<any> Promise that will complete once the complete vnode tree is traversed. Note that even if
15 *         a Suspension throws the returned promise will resolve.
16 */
17export default function prepass(vnode: preact.VNode, visitor?: Visitor, context:? Object): Promise<any>;

Replace react-ssr-prepass (e.g. next.js)

react-ssr-prepass is usually used on the server only and not bundled into your bundles but rather required through Node.js. To alias react-ssr-prepass to preact-ssr-prepass we recommend to use module-alias:

Create a file named alias.js:

1const moduleAlias = require('module-alias')
2
3module.exports = () => {
4  moduleAlias.addAlias('react-ssr-prepass', 'preact-ssr-prepass')
5}

Require and execute the exported function in your applications entrypoint (before require'ing react-ssr-prepass):

1require('./alias')();

Differences to `react-ssr-prepass`

The visitor passed to preact-ssr-prepass gets a Preact element instead of a React one. When you use preact/compat's createElement it will make the element/vnode look as similar to a React element as possible.

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

6

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

License

Determines if the project has defined a license.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Security-Policy

Determines if the project has published a security policy.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Reason

39 existing vulnerabilities detected

Details

Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
Warn: Project is vulnerable to: GHSA-h5c3-5r3r-rr8q
Warn: Project is vulnerable to: GHSA-rmvr-2pp2-xj38
Warn: Project is vulnerable to: GHSA-xx4v-prfh-6cgc
Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw
Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
Warn: Project is vulnerable to: GHSA-pfrx-2q88-qq97
Warn: Project is vulnerable to: GHSA-rc47-6667-2j5j
Warn: Project is vulnerable to: GHSA-7r28-3m3f-r2pr
Warn: Project is vulnerable to: GHSA-r8j5-h5cx-65gg
Warn: Project is vulnerable to: GHSA-896r-f27r-55mw
Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
Warn: Project is vulnerable to: GHSA-76p3-8jx3-jpfq
Warn: Project is vulnerable to: GHSA-3rfm-jhwj-7488
Warn: Project is vulnerable to: GHSA-hhq3-ff78-jv3g
Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
Warn: Project is vulnerable to: GHSA-mwcw-c2x4-8c55
Warn: Project is vulnerable to: GHSA-r683-j2x4-v87g
Warn: Project is vulnerable to: GHSA-px4h-xg32-q955
Warn: Project is vulnerable to: GHSA-rp65-9cf3-cjxr
Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9
Warn: Project is vulnerable to: GHSA-7fh5-64p2-3v2j
Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp
Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6
Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-4rq4-32rv-6wp6
Warn: Project is vulnerable to: GHSA-64g7-mvw6-v9qj
Warn: Project is vulnerable to: GHSA-4wf5-vphf-c2xc
Warn: Project is vulnerable to: GHSA-jgrx-mgxx-jf9v
Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7
Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q

Score

2.8

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to preact-ssr-prepass

Other packages similar to preact-ssr-prepass

preact-ssr-prepass

Installations

Developer Guide

Yes

CommonJS, ESM

22.4.0

10.8.1

Pull Requests

11

52

9

32

Issues

3

11

8

Releases

Languages

Developer

sventschui

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Peer Dependencies

Dev Dependencies

preact-ssr-prepass

Usage / API

Awaiting suspensions

Custom suspensions/data fetching using the visitor

API

Replace react-ssr-prepass (e.g. next.js)

Differences to react-ssr-prepass

10

10

6

0

0

0

0

0

0

0

0

0

0

2.8

/10

Differences to `react-ssr-prepass`