Skip to content
Convert a Shapefile to GeoJSON. Not many caveats.
JavaScript CSS HTML
Branch: gh-pages
Clone or download

Latest commit

Latest commit 11c5c10 May 14, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
dist fix loading/buffers May 5, 2020
files test empty shapefiles Mar 22, 2016
lib fix loading/buffers May 5, 2020
site update demo Oct 6, 2013
test fix loading/buffers May 5, 2020
.gitignore fix loading/buffers May 5, 2020
.jshintrc WIP test updats May 27, 2014
.npmignore npm ignore Sep 12, 2013 Merge branch 'buffer-rewrite' into gh-pages Jun 9, 2017
bower.json update for build Mar 23, 2016
index.html use browserify Nov 1, 2013
package.json 3.5.0 May 14, 2020


If you are having encoding issues in internet explorer please include this script as well.

Redoing all of this in modern JS. Promises, Typed Arrays, other hipster things, I wouldn't say it's based on RandomEtc's version as much as inspired by it as there is 0 code shared and I really only read the binary ajax part of his (hence why my function has the same name, they are otherwise not related). My sources were:



For use with browserify, webpack:

npm install shpjs --save

Or include directly in your webpage from:


Has a function shp which accepts a string which is the path the she shapefile minus the extension and returns a promise which resolves into geojson.

	//for the shapefiles in the folder called 'files' with the name pandr.shp
		//do something with your geojson

or you can call it on a .zip file which contains the shapefile

	//for the shapefiles in the files folder called pandr.shp
		//see bellow for whats here this internally call shp.parseZip()

or if you got the zip some other way (like the File API) then with the arrayBuffer you can call

shp.parseZip(buffer)->returns zip

If there is only one shp in the zipefile it returns geojson, if there are multiple then it will be an array. All of the geojson objects have an extra key fileName the value of which is the name of the shapefile minus the extension (I.E. the part of the name that's the same for all of them)

You could also load the arraybuffers seperately:

shp.combine([shp.parseShp(shpBuffer, /*optional prj str*/),shp.parseDbf(dbfBuffer)]);

Stick it in a worker

I used my library catiline to parallelize the demos to do so I changed

<script src='dist/shp.js'> </script>
		//do stuff with data


<script src='website/catiline.js'> </script>
	var worker = cw(function(base,cb){
	//worker can be called multiple times'files/')).then(function(data){
		//do stuff with data

to send the worker a buffer from the file api you'd do (I'm omitting where you include the catiline script)

var worker = cw(function(data){
	return shp.parseZip(data);
	//do stuff with data


  • Binary Ajax
  • parsing the shp
  • parse the dbf
  • join em
  • zip
  • file api
  • Some Projections
  • More Projections

to do

  • check for geometry validity.
  • Tests


Main library MIT license, original version was less permissive but there is 0 code shared. Included libraries are under their respective lisenses which are:

Dependency Status devDependency Status peerDependency Status

You can’t perform that action at this time.